从本版本开始,gma 1.x 不再维护。一方面是由于精力和时间有限,另一方面由于 gma 2.x 与 1.x 相差巨大,同时维护两个相差巨大的版本较困难。
本版本 (gma 2.0.0a2)依旧为预览版,但内容已趋于稳定,若没有较大BUG,下一版则作为正式版发布。
安装 gma 2.0.0a2
pip install gma==2.0.0a2
新增
1、添加 【gft】地理文件格式模块
a. 新增 **栅格(GetRasterFormat)/矢量(GetVectorFormat)**方法,用以初始化一个 栅格/矢量 格式
- 提供完整的 栅格(/矢量 文件格式信息查看和配置高级创建选项(通过 SetCreationOptions 方法)等操作。
- 现在,所有 栅格/矢量 处理函数的 Format/OutFormat 等格式相关参数同步支持配置的自定义格式类,以便将自定义的高级创建选项应用于栅格/矢量创建过程中。
注意: 目前,gma 仅会对高级创建选项进行简单检查,并按照以下规则处理异常配置:
- 不支持的创建选项:直接移除
- 错误的创建选项:直接忽略
b. 新增 栅格(RasterSummary)/矢量(VectorSummary)概括方法,用以查看 gma 所支持的所有 栅格/矢量 格式 信息。
2、新增 【Extraction】 提取分析模块
a. 新增 【ExtractValues】函数。根据点坐标从栅格数据集提取值至 pandas 数据帧(DataFrame)。
修复
1、修复了数组保存为栅格时,默认压缩方式丢失的问题。
2、修复了 io.ReadArrayAsDataSet 函数异常的问题。
3、修复了 io.CreateLayer 返回值为空的问题。
简单示例1:提取点值
from gma.map import inres
from gma import smc
## 使用内置数据做示例
DataSet = inres.WorldDataSet.NaturalEarth
EXTData = smc.Extraction.ExtractValues([[1,2], [9.0,67.5], [77, 99]], DataSet)
X | Y | Band0 | Band1 | Band2 | |
---|---|---|---|---|---|
0 | 1.0 | 2.0 | 123 | 169 | 206 |
1 | 9.0 | 67.5 | 172 | 202 | 224 |
简单示例2:为 GTiff 格式配置高级创建参数(以修改压缩方式为例)
from gma.map import inres
from gma import gft
## 使用内置数据做示例
DataSet = inres.WorldDataSet.NaturalEarth
## 另存一个 GTiff 文件(默认为 DEFLATE 压缩)用以对比
DataSet.SaveAs(r'D:\NaturalEarth.tif', Format = 'GTiff')
## 0. 创建一个 'GTiff' 栅格驱动格式
GTiff = gft.GetRasterFormat(Format = 'GTiff')
## 1. 重新设置创建选项中压缩配置(COMPRESS)参数为 LZW 压缩
GTiff.SetCreationOptions(COMPRESS = 'LZW')
## 1.1 可通过如下方法查看当前格式支持的所有配置参数(这里不做示例)
## GTiff.CreationOptionInfo
## 2. 应用自定义的栅格驱动另存数据集
DataSet.SaveAs(r'D:\NaturalEarth_LZW.tif', Format = GTiff)
利用 ArcGIS 查看生成结果
gma 网站和功能说明
gma 网站:gma.luosgeo.com
注意:网站针对 1.x 版本内容,2.x 版本中部分函数功能已经调整或变更,详见内置帮助。2.x 功能参考下图: