数据格式说明

大贤风格

大贤 · 风格平台提供多种数据格式的下载功能, 包括json, csv, netcdf(nc), wws等。 其中最为通用的格式为json, 几乎每种数据都可转换为特定格式的json文件。

JSON格式

本平台提供的json文件分为两类, 一类是描述数据的基本单位, 称为数据单元(DataUnit); 另一类是包含若干个数据单元的数据包(DataPack)。这两类格式都具有特定的结构规范。

数据单元(DataUnit)

数据单元中都包含如下的基本属性:

  1. {
  2.     "type": "dataunit",
  3.     "uri": "本数据单元的唯一标识",
  4.     "info": {  
  5.         // 描述性信息
  6.         "varname": 变量名,
  7.         "zh_varname": 中文变量名,
  8.         "type": 数据类型,
  9.         "sample": true | false  //该数据是样品还是完整数据
  10.     },
  11.     "data": {
  12.         // 因类型而异的各种属性
  13.         ...
  14.     }
  15. }

各类数据的数据单元内容要素如下:

时间序列数据

  1. {
  2.     "type": "dataunit",
  3.     "uri": URI,
  4.     "info": {
  5.         "varname": 变量名,
  6.         "zh_varname": 中文变量名,
  7.         "type": "timeseries",
  8.         "sample": true | false
  9.     },
  10.     "data": {
  11.         // dts 或 (begdt + interval)二者选一, 
  12.         "dts": [时, 间, 列, 表 ...],   // 秒时间戳
  13.         "begdt": 开始时间,    // 秒时间戳
  14.         "interval": 时间间隔,   // 秒数
  15.         "values": [序, 列, 值, ...],
  16.         "units": 单位,
  17.         "suggest_range": 推荐的数据范围,
  18.     }
  19. }

年统计汇总数据

  1. {
  2.     "type": "dataunit",
  3.     "uri": URI,
  4.     "info": {
  5.         "varname": 变量名,
  6.         "zh_varname": 中文变量名,
  7.         "type": "summary",  // 或更具体的, 如wrf_summary, merra_summary等
  8.         "sample": true | false,
  9.         "sub_varnames": [子, 变, 量, 名, ...]
  10.     },
  11.     "data": {
  12.         "变量1": {
  13.             "name": "变量1", 
  14.             "values": 平均值,  // 注意, 虽是单个值, 名称依然是"values"
  15.             "count": 样本数,
  16.             "std": 标准差,
  17.             "units": 单位
  18.         },
  19.         "变量2": {
  20.             ...
  21.         }, 
  22.         ...
  23.     }
  24. }

风玫瑰 & 风功率玫瑰

  1. {
  2.     "type": "dataunit",
  3.     "uri": URI,
  4.     "info": {
  5.         "varname": 变量名,
  6.         "zh_varname": 中文变量名,
  7.         "type": "rose",
  8.         "sample": true | false
  9.     },
  10.     "data": {
  11.         "wsbinnum": 风速段数量,
  12.         "wdbinnum": 风向扇区数,
  13.         "wsbins": [风, 速, 段 ... ]
  14.         "wdbins": [风, 向, 扇, 区, ...],
  15.         "wdbin0": 第一个风向扇区方向,
  16.         "values": [ [风,玫,瑰,二,维,数,组] ],  // 数组形状: (wsbinnum, wdbinnum)
  17.         "count": 样本数,
  18.         "units": 单位,
  19.     }
  20. }

风频分布 & 风功率密度分布

  1. {
  2.     "type": "dataunit",
  3.     "uri": URI,
  4.     "info": {
  5.         "varname": 变量名,
  6.         "zh_varname": 中文变量名,
  7.         "type": "winddist" | "wpddist",
  8.         "sample": true | false
  9.     },
  10.     "data": {
  11.         "wsbinnum": 风速段数量,
  12.         "wdbinnum": 风向扇区数,
  13.         "wsbins": [风, 速, 段 ... ]
  14.         "wdbins": [风, 向, 扇, 区, ...],
  15.         "wdbin0": 第一个风向扇区方向,
  16.         "wsdist": [按,风,速,段,分,布],
  17.         "wddist": [按,风,向,扇,区,分,布],
  18.         "wdcdist": [按,风,向,扇,区,分,布,(含,静,风)],
  19.         "calm_thres": 静风阈值,
  20.         "weibull_a": 威布尔分布A值,  //仅在winddist中有
  21.         "weibull_k": 威布尔分布K值,  //仅在winddist中有
  22.         "count": 样本数,
  23.         "units": 单位,
  24.     }
  25. }

点月统计数据 PM

  1. {
  2.     "type": "dataunit",
  3.     "uri": URI,
  4.     "info": {
  5.         "varname": 变量名,
  6.         "zh_varname": 中文变量名,
  7.         "type": "monthlymean",
  8.         "sample": true | false
  9.     },
  10.     "data": {
  11.         "values": [12,个,平,均,值...],
  12.         "std": [12,个,标,准,差...],
  13.         "count": [12,个,样,本,数...],
  14.         "units": 单位,
  15.     }
  16. }

点日变化数据 PD

  1. {
  2.     "type": "dataunit",
  3.     "uri": URI,
  4.     "info": {  
  5.         "varname": 变量名,
  6.         "zh_varname": 中文变量名,
  7.         "type": "diurnalmean",
  8.         "sample": true | false
  9.     },
  10.     "data": {
  11.         "values": [24,个,平,均,值...],
  12.         "std": [24,个,标,准,差...],
  13.         "count": [24,个,样,本,数...],
  14.         "units": 单位,
  15.     }
  16. }

数据包(DataPack)

数据包的基本结构规则如下:

  1. {
  2.     "type": "datapack",
  3.     "uri": "本数据包的唯一标识",
  4.     "tags": {
  5.             "标签1": "数据单元1的唯一标识",
  6.             "标签2": "数据单元2的唯一标识",
  7.             ...
  8.     },
  9.     "contents": {
  10.         "标签1": {数据单元1},
  11.         "标签2": {数据单元2},
  12.         ...
  13.     }
  14. }