geomodels 1.0.0b4

关于

GeoModels提供地球模型（如大地水准面、重力模型和磁场模型）管理的工具。

它还提供了一些实用函数，用于下载和安装地球模型计算所需的支撑数据。

它基本上是Cython对GeographicLib C++库的部分封装。

安装

GeoModels需要Python >= 3.6。要使用GeoModels，需要以下Python包

• numpy

• tqdm（可选）

• argcomplete（可选）

所需的Python包由Pip和setuptools自动安装

$ python3 -m pip install geomodels

有关安装选项的详细信息，请参阅Pip用户手册，有关从源安装的详细信息，请参阅文档中的安装部分。

模型数据安装

GeoModels使用外部数据进行大地水准面、重力和磁场计算。

如果系统上没有所需的支撑数据，可以使用GeoModels包提供的命令行界面下载和安装

$ python -m geomodels install-data [-d DATADIR] recommended

上述命令将推荐的子数据集（约20MB）安装到指定的 DATAROOT 文件夹。如果未使用 -d（或 –datadir）选项显式指定 DATAROOT，则使用默认系统路径（例如 /usr/local/share/GeographicLib）。

无论如何，都需要在 DATADIR 文件夹上具有写入权限，因此要将安装到默认系统路径，可能需要使用 sudo 或其他等效方法。

如果数据未安装到默认系统文件夹，则需要将 GEOGRAPHICLIB_DATA 环境变量设置为数据安装路径，以便 GeographicLib 能够找到数据。例如，在bash使用的系统上，可以使用以下命令

export GEOGRAPHICLIB_DATA=/path/to/data

测试

一旦安装了GeoModels包和必要的数据，就可以运行测试套件以确保一切正常工作。使用 PyTest 测试GeoModels的推荐方法是

$ env GEOGRAPHICLIB_DATA=/path/to/data \
  python3 -m pytest --pyargs geomodels

使用示例

>>> from geomodels import GeoidModel
>>> geoid = GeoidModel()
>>> geoid.description()
'WGS84 EGM96, 5-minute grid'
>>> geoid(lat=40.667, lon=16.6)  # -> geoid height
45.914894760480024

许可协议

GeoModels是在MIT/X11 许可证的条款下发布的（请参阅LICENSE文件）。