webgeodyn 0.10.5

安装

pip3 install webgeodyn [--user]

git clone https://gricad-gitlab.univ-grenoble-alpes.fr/Geodynamo/webgeodyn.git

cd webgeodyn
python3 setup.py install [--user]

python3 -c "import webgeodyn; print(webgeodyn.__version__)"

运行示例

您可以通过运行示例来尝试启动 Web 服务器

python3 webgeodyn/example.py

或在 Python 控制台中

>>> import webgeodyn.example
>>> webgeodyn.example.run()

这将在本地启动服务器，并应打开您的浏览器并显示类似于 https://geodyn.univ-grenoble-alpes.fr/ 的页面。如果没有，请在浏览器中尝试输入 http://localhost:8080。

您可以在加载的示例模型（CHAOS-7）上尝试不同的可视化工具。

注意，此示例还将尝试加载最新 pygeodyn（由我们小组开发的地磁数据同化 Python 包）的计算结果（如果存在于 ~/pygeodyn_results/Current_computation/ 中）。

使用您的数据运行服务器

服务器可以用于可视化任何受支持的格式的数据。为此，您必须遵循 example.py 的模板。

• 首先，将数据以 Model 对象的形式加载到 Models 字典中，指定名称和格式。

• 然后，必须使用加载的 Models 启动服务器。

下面将详细介绍。

# 0.Import the necessary submodules
import webgeodyn.server
import webgeodyn.models

# 1.Initialising the Models dictionary
models = webgeodyn.models.Models()

# 2.Loading your data in the Models dictionary
# Syntax: models.loadModel('/path/to/the/model/directory', "Name of the model", "Format of the model")
# Example for pygeodyn:
models.loadModel('pygeodyn_results/Current_computation', 'Current pygeodyn computation', 'pygeodyn_hdf5')
# Several models can be loaded at once. Example for CHAOS:
models.loadModel('webgeodyn/webgeodyn/example_data/CHAOS-7', 'CHAOS-7.13', 'CHAOS')

# 3.Start the server with the loaded Models
webgeodyn.server.startServer(models,{})

通过将此代码复制到您的 Python 文件中，您应该能够使用支持格式的数据上的可视化工具。

定义要读取的文件格式的模型格式是 webgeodyn.inout 的模块。以下是一些数据格式示例：

• archomag：读取 COVARCH et COVLAKE 文件

• chaos：读取 CHAOS 分片文件

• covobs：读取基于球谐基的 COVOBS 实现文件

• covobs_splines：读取填充有分片系数的 COVOBS 实现文件

• enscore：读取使用 [GBF15]- 生成文件

• pygeodyn_asc：用于旧 ASCII 格式文件，该格式在 pygeodyn 中使用

• pygeodyn_hdf5：读取由 pygeodyn 生成 HDF5 文件

• ZForecast：读取由 [BHF18] 或 [BGA17] 生成文件

可以通过运行显示格式列表

>>> import webgeodyn.inout
>>> print(webgeodyn.inout._formats)

如果您需要支持新的文件格式，您可以根据 webgeodyn.inout 文档中给出的模板实现自己的加载函数。否则，您可以使用以下信息联系我们。

开发者文档

包的子模块文档可在 网上 获取。

如果已安装 Sphinx 并从存储库克隆了文件，则可以使用以下方式生成本地文档：

cd doc && ./make_all_doc.sh

然后，文档将以 HTML 格式在 doc/html/index.html 中可用。

使用条件

本作品受 GNU GPLv3 许可。

Git 存储库

源代码存储在Git仓库中（https://gricad-gitlab.univ-grenoble-alpes.fr/Geodynamo/webgeodyn），也可以通过问题提供反馈。

参考文献

联系方式

对于科学咨询，请联系Nicolas Gillet。对于技术问题，请联系Francois Dallasta 和/或 Franck Thollard。