用于通过kiwis api访问kisters-wiski系统的python库。
kiwis-pie的Python项目详细描述
用于通过kiwis查询wiski的python库(kisters web互操作性解决方案)。见:http://www.kisters.net/NA/products/wiski/options/web-services/
依赖关系
需要python库请求、熊猫和表格。
安装
从pypi安装:
pip install kiwis-pie
或者直接从github安装:
pip install git+https://github.com/amacd31/kiwis_pie.git
用法
从kiwis服务获取一些数据的示例,该服务支持:http://kna.kisters.net/sjr/kiwidgets/tests/SanJoaquinRiver/
from datetime import date from kiwis_pie import KIWIS k = KIWIS('http://kna.kisters.net/grassland/KiWIS') # Get station ID for 'SAN JOAQUIN RIVER NEAR PATTERSON' station_id = k.get_station_list(station_name = 'SAN JOAQUIN RIVER NEAR PATTERSON').station_id.values[0] # Get timeseries ID for 3-Hourly streamflow (Q) at SAN JOAQUIN RIVER NEAR PATTERSON ts_id = k.get_timeseries_list(station_id = station_id, parametertype_name = 'Q', ts_name = '3-Hourly').ts_id.values[0] # Read one day of 3-Hourly flow data for SAN JOAQUIN RIVER NEAR PATTERSON k.get_timeseries_values(ts_id = ts_id, to = date(2016,1,1), **{'from': date(2016,1,1)})
使用支持澳大利亚气象局水数据在线服务的kiwis服务的示例:http://www.bom.gov.au/waterdata/
from datetime import date from kiwis_pie import KIWIS k = KIWIS('http://www.bom.gov.au/waterdata/services') # Get station ID for 'Cotter River at Gingera' station_id = k.get_station_list(station_name = 'Cotter R. at Gingera').station_id.values[0] # Get timeseries ID for daily mean streamflow (Q) at Cotter River at Gingera ts_id = k.get_timeseries_list(station_id = station_id, ts_name = 'DMQaQc.Merged.DailyMean.24HR', parametertype_name = 'Water Course Discharge').ts_id.values[0] # Read 31 days of daily water course discharge data for Cotter River at Gingera k.get_timeseries_values(ts_id = ts_id, to = date(2016,1,31), **{'from': date(2016,1,1)}) # Optionally use the `keep_tz` option to return in local timezone instead of UTC k.get_timeseries_values(ts_id = ts_id, to = date(2016,1,31), **{'from': date(2016,1,1)}, keep_tz=True)
文档
kiwis类上的方法都有docstrings,详细说明它们采用的关键字参数。 在阅读文档时可以获得呈现的文档:http://kiwis-pie.readthedocs.io/en/latest/