Adampy 的文档

描述

Adampy 允许检索、分析和下载托管在 ADAM 环境中的数据。

安装程序

virtualenv -p `which python3` venv
source venv/bin/activate
python3 -m pip install --upgrade pip
pip install adampy

功能

获取收藏

getCollections 函数返回所选端点中的所有可用集合。

adam.getCollections(endpoint).get_data()

参数

• endpoint (str) - 从中​​获取集合的端点的名称。

退货

• 包含所有集合名称的列表

例子

要获取集合列表：

import adampy as adam

collections = adam.getCollections('wcs-eo4sdcr.adamplatform.eu').get_data()

print(collections)

获取图像

getImage 函数返回一个包含请求图像的 numpy 数组。可以使用 Rasterio 保存图像。

adam.getImage(endpoint, collection, time_t, min_lat = -90, max_lat = 90, min_long = -180, max_long = 180, token = 'None', geometry = 'None', masking = False, fname = 'image.tif').get_data()

参数

• endpoint (str) - 从中​​获取集合的端点的名称。
• collection (str) - 集合的名称
• time_t (str) - 格式为 yyyy-mm-ddThh:mm:ss 的时间或时间范围
• min_lat（int 或 float；可选）- 边界框的最小纬度（范围 -90 到 90）
• max_lat（int 或 float；可选）- 边界框的最大纬度（范围 -90 到 90）
• min_long（int 或 float；可选）- 边界框的最小经度（范围 -180 到 180）
• max_long（int 或 float；可选）- 边界框的最大经度（范围 -180 到 180）
• token (str; optional) - 访问受限集合的令牌
• 几何（shp、geojson 或 kml 文件；可选）- 用于掩盖输出图像的几何
• 掩蔽（True 或 False；默认 False；可选）- 激活掩蔽选项
• fname (str; optional) - 输出文件的名称，如果没有说明 fname = image.tif

退货

• 具有请求的图像和图像元数据信息的 Numpy 数组

例子

获取特定时间的全局图像

import adampy as adam
import matplotlib
import matplotlib.pyplot as plt

image, out_meta = adam.getImage('wcs-eo4sdcr.adamplatform.eu', 'Z_CAMS_C_ECMF_PM10_4326_04','2019-03-26T00:00:00').get_data()

plt.subplots(figsize=(13,13))
plt.imshow(image)

获取特定时间的边界框

import adampy as adam
import matplotlib
import matplotlib.pyplot as plt

image, out_meta = adam.getImage('wcs-eo4sdcr.adamplatform.eu', 'Z_CAMS_C_ECMF_PM10_4326_04','2019-03-26T00:00:00',10,20,-10,50).get_data()

plt.subplots(figsize=(13,13))
plt.imshow(image)

获取时间范围的边界框

import adampy as adam
import matplotlib
import matplotlib.pyplot as plt

image, out_meta = adam.getImage('wcs-eo4sdcr.adamplatform.eu', 'Z_CAMS_C_ECMF_PM10_4326_04','2019-03-26T00:00:00,2019-03-27T23:59:59',10,20,-10,50).get_data()

plt.subplots(figsize=(13,13))
plt.imshow(image)

获取时间范围内的蒙版图像

import adampy as adam
import matplotlib
import matplotlib.pyplot as plt

image, out_meta = adam.getImage('wcs-eo4sdcr.adamplatform.eu', 'Z_CAMS_C_ECMF_PM10_4326_04','2019-03-26T00:00:00,2019-03-27T23:59:59', geometry = 'polygon.shp', masking = True).get_data()

plt.subplots(figsize=(13,13))
plt.imshow(image)

获取时间序列

getTimeSeries 函数返回两个数组，其中包含请求纬度和经度位置的值和时间戳。

adam.getTimeSeries(endpoint, collection, time_t, lat, long, token = 'None').get_data()

参数

• endpoint (str) - 从中​​获取集合的端点的名称。
• collection (str) - 集合的名称
• time_t (str) - 格式为 yyyy-mm-ddThh:mm:ss 的时间或时间范围
• lat（int 或 float；可选）- 边界框的最小纬度（范围 -90 到 90）
• long (int or float; optional) - 边界框的最小经度（范围 -180 到 180）
• token (str; optional) - 访问受限集合的令牌

退货

• 包含请求纬度和经度位置的值和时间戳的两个数组

例子

import adampy as adam

data, times = adam.getTimeSeries('wcs-eo4sdcr.adamplatform.eu', 'ERA-Interim_temp2m_4326_05','2014-03-26T00:00:00,2014-03-30T23:59:59', 25, 60).get_data()

获取动画

getAnimation 函数在给定开始和结束日期的情况下创建数据集的动画 gif。

adam.getTimeSeries(endpoint, collection, start_date, end_date, min_lat = -90, max_lat = 90, min_long = -180, max_long = 180, token = 'None', frame_duration = 0.1, legend = False).get_data()

参数

• endpoint (str) - 从中​​获取集合的端点的名称。
• collection (str) - 集合的名称
• start_date (date object) - 动画的开始日期
• end_date (date object) - 动画的结束日期
• min_lat（int 或 float；可选）- 边界框的最小纬度（范围 -90 到 90）
• max_lat（int 或 float；可选）- 边界框的最大纬度（范围 -90 到 90）
• min_long（int 或 float；可选）- 边界框的最小经度（范围 -180 到 180）
• max_long（int 或 float；可选）- 边界框的最大经度（范围 -180 到 180）
• token (str; optional) - 访问受限集合的令牌
• frame_duration (float or int; optional) - 以秒为单位的帧持续时间
• legend (True or False; optional) - 为动画添加图例

退货

• 给定开始和结束日期的数据集的动画 GIF。

例子

import adampy as adam
from datetime import datetime, timedelta, date

start_date = date(2014,3,1)
end_date = date(2014,3,5)

gif_fname = adam.getAnimation('wcs-eo4sdcr.adamplatform.eu', 'NEXGDDP-pr_4326_025',start_date = start_date, end_date=end_date, frame_duration = 0.3, legend = False).get_data()