Skip to content

Commit

Permalink
Reorganize dataset chapters (#1363)
Browse files Browse the repository at this point in the history
  • Loading branch information
ZMAlt authored Oct 9, 2024
1 parent 182e044 commit 8bc8da3
Show file tree
Hide file tree
Showing 13 changed files with 261 additions and 296 deletions.
30 changes: 0 additions & 30 deletions source/dataset-CN/index.md

This file was deleted.

File renamed without changes
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -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}
Expand Down
12 changes: 8 additions & 4 deletions source/dataset-CN/CN-border.md → source/dataset/CN-border.md
Original file line number Diff line number Diff line change
Expand Up @@ -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**)绘制中国国界省界数据:
Expand Down
10 changes: 7 additions & 3 deletions source/dataset-CN/CN-faults.md → source/dataset/CN-faults.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` 即为中国区域主要断层。

## 示例图

Expand Down
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
117 changes: 53 additions & 64 deletions source/dataset/index.md
Original file line number Diff line number Diff line change
@@ -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 不支持这一功能。

Loading

0 comments on commit 8bc8da3

Please sign in to comment.