girder_geospatial

安装

1. 安装girder.

2. 在您的系统上安装2或更高版本的gdal。

   • 使用wheel安装，运行

       pip install gdal -f https://manthey.github.io/large_image_wheels/
     

   • 如果不使用wheel安装

     • 使用上述说明在您的系统上安装gdal
     • 通过运行gdal-config --version来检查系统gdal版本
     • 使用pip安装相应的gdal版本

3. 通过运行来测试您的gdal安装

python -c "from osgeo import gdal"

4. 安装地理空间插件和所需的类型包。

pip install girder-geospatial
pip install girder-geospatial-raster \
            girder-geospatial-vector \
            girder-geospatial-grid

5. 通过将以下内容添加到您的girder配置文件来启用Girder缓存

[cache]
enabled = True
cache.global.backend = "dogpile.cache.memory"
cache.request.backend = "cherrypy_request"

用法

1. 上传地理空间文件

   在Girder中启用插件后，只需上传gdal或ogr可以处理的地理空间文件。要查看支持的格式列表，请参阅gdal和ogr格式文档。此插件响应上传文件事件。文件上传将触发一个处理程序，该处理程序将自动在上传文件的项上设置地理空间元数据。

2. 在已存在的项上创建地理空间元数据

   如果您已经在Girder中有数据，并且不想重新上传您的数据。有一个端点接受一个项ID，并在该项上创建地理空间元数据。

   curl '{girderApiUrl}/item/{itemId}/geometa' -X PUT
   

   此端点将检查文件并将 'geometa' 键附加到给定项。

3. 在现有项上创建任意地理空间元数据

   一些用户可能希望对所保存的内容有更多控制。选项 2 中的同一端点可以用来创建遵循 基本模式 的任意元数据。换句话说，只要您有在基本模式中定义的所需参数，您就可以自由地为您的目的添加自己的附加数据。

   curl '{girderApiUrl}/item/{itemId}/geometa?geometa={geospatialMetadata}' -X PUT
   

4. 查询 mongo 地理空间数据集

   要查询 mongo，请使用以下具有必需查询参数的端点。

   curl '{girderApiUrl}/item/geometa?{necessaryQueryStringParameters} -X GET
   

   此端点接受多种地理空间查询，包括

   1. WKT 几何和关系
   2. 边界框和关系
   3. Geojson 几何和关系
   4. 纬度、经度和半径。

   当提供纬度、经度和半径时，关系始终是“在...内”，而不是“相交”。这可能会产生意外结果。我们建议使用上述选项 1、2 或 3。

   此外，请注意这些选项是相互排斥的，因此您不能同时传递 geojson 和边界框选项。《a href="https://github.com/OpenGeoscience/girder_geospatial/blob/add-endpoint-documentation/geometa/schema/opensearchgeo.py#L61-L147" rel="nofollow">Opensearch Geo 模式验证器 如果传递了相互排斥的参数，则会引发异常。

5. 从项中获取 geometa

   要获取项上的地理空间元数据，请调用以下端点

   curl '{girderApiUrl}/item/{itemId}/geometa' -X GET
   

Vagrant 示例

目前有 2 个 vagrant 示例 可快速启动。如果您在安装此插件时遇到问题，请检查 ubuntu-16.04 和 ubuntu-18.04 的 ansible playbooks。

运行测试

cd geometa
pip install -r requirements-dev.txt
pytest -n 4