美国国家海洋和大气管理局国家数据浮标中心包装
buoyant的Python项目详细描述
浮标是一个python包装器，用于从National Buoy Data Center中获取浮标数据。它从 NBDC终结点。这个数据源没有完整的文档，所以没有 保证其稳定性。
NBDC提供一个list 以及活跃的浮标。
你好浮标示例：
frombuoyantimportBuoy# construct the Buoy object with the station ID# It's an alphanumeric code. If its numeric, an integer works fine.station=Buoy(13010)station.name# 'Soul'# Yes, that buoy is really named Soul.
更多示例：
frombuoyantimportBuoystation=Buoy('lndc1')station.wind_speed# 9.9station.units['wind_speed']# 'kt'station.lon# -23.14station.coords# (20.43, -23.14)# Get the time the measurements were made.station.datetime# datetime.datetime(2014, 12, 15, 20, 50, tzinfo=<UTC>)# Not all stations report all data.station.wave_height# raises AttributeError# Fetches new data. This isn't very useful, since the buoys update only every hour or sostation.refresh()
图像
有些浮标有摄像头！如果浮标没有活动摄像机， NBDC提供的占位符图像将被返回。
station=Buoy(41009)station.image_url# 'http://www.ndbc.noaa.gov/images/buoycam/Z14C_2014_11_01_2200.jpg'# Save image as a file 'out.jpg'station.write_image('out.jpg')# Get raw image as a BytesIO object (see https://docs.python.org/2/library/io.html)station.image# <_io.BytesIO object>station.url# 'http://www.ndbc.noaa.gov/station_page.php?station=41009'
测量元数据
偶然浮标报告有关其测量的元数据。这个 Buoyobject有一个包含此数据的元属性（如果有的话）。
# Buoy in the Frying Pan Shoals, NCfrying_pan=Buoy(41013)frying_pan.pressure# 30.1frying_pan.meta['pressure']# {'tendency': 'steady'}
无数据
有时浮标没有最近的数据。你可以告诉我两种方法。 首先，Buoy对象没有很多属性。第二，那里 将是一个消息。它会说“没有数据”。
station=Buoy('ANRN6')station.message# 'No data'
包括测量值
NBDC的XML API中报告的任何度量都包含在 Buoy对象。Read about the meaning of the different measurements。
通常包括测量值（括号中的文本是 NBDC的measurement descriptions page）：
- 空气温度（ATMP）
- 平均周期（apd）
- 优势周期（dpd）
- 平均波方向（谱波方向）
- 水温（wtmp）
- 波高（wvht）
- 风向（WDIR）
- 阵风（gst）
- 风速（wspd）
- 日期时间
- 露点（露点）
- 纬度
- lon（经度）
- 压力（pres）
XML数据源中不包含水质数据。也不是 站点的高程或仪器相对于 车站。
XML
如果您出于某种原因喜欢xml，请获取原始xml。也许包裹是 遗漏了什么？如果是，请提交 issue或pull request！
soul=Buoy('13010')soul.xml'''<?xml version="1.0" encoding="UTF-8"?> <observation id="13010" name="Soul" lat="-0.01" lon="0.00"> <datetime>2014-12-16T02:00:00UTC</datetime> <winddir uom="degT">190</winddir> <windspeed uom="kt">9.9</windspeed> <airtemp uom="F">78.8</airtemp> </observation>'''
兼容性
浮力与Python2和3兼容。
许可证
浮标是根据 GPL。
欢迎加入QQ群-->： 979659372
