气象卫星createQuantLayer

FY-4B AGRI L2 经纬定量场。文件须带一维经纬坐标，format: 'nc'，必须写 product，按该 key 取列。工厂 createQuantLayer。下表是库内带默认色标的产品。同一规范的其它变量见 自行绘制。每个要素的绘制写在该产品的「能力」里。

参数

本页绘制用这些字段。范围写在记录的经纬界上。

参数	必选	用途	默认
data	必选	解析出口的 values，一条经纬格网记录	—
product	必选	画哪一列，与 parse 的 product 相同	—
pieces	可选	分档色标。内置产品可省	产品默认档
range	可选	过滤可见数值	全开
fill	可选	连续场可切 cells / isobands / gradient；clm / snc / fhs 只认逐格	cells
convert	可选	绘制换算 (value) => number。自定义时必须同时传 pieces。分类码不能写	不换算
opacity	可选	透明度，透出底图	0.8
显示与交互	可选	见 图层	—

产品	key	单位	能力
向外长波辐射	olr	W/m²	绘制：逐格 / 等值面 / 渐变 · 数据裁剪
定量降水估计	qpe	mm/h	绘制：逐格 / 等值面 / 渐变
云掩膜	clm	类号	绘制：只认逐格
火点	fhs	类号	绘制：只认逐格
陆表温度	lst	K	绘制：逐格 / 等值面 / 渐变
积雪覆盖	snc	类号	绘制：只认逐格
短波黑空反照率	bsa	—	绘制：逐格 / 等值面 / 渐变
短波白空反照率	wsa	—	绘制：逐格 / 等值面 / 渐变

数据

八个产品同一套 经纬 NC 原件。HDF5 / NetCDF4，文件头 4 字节是 89 48 44 46。必须有一维 lon / lat，要素变量维是 (lat, lon)。

HDF5 / NetCDF4
lon[]
lat[]
要素变量 (lat, lon)

参数	含义
HDF5 签名	认文件靠它
lon	一维经度，必须西向东递增。西界取第一个值
lat	一维纬度。第 0 行在北；源 lat 从南往北则翻行
要素变量	按 parse 的 product 取列。对上只出这一列
scale_factor / add_offset	变量属性。物理量 = 存储值 × 比例 + 偏移
_FillValue / FillValue	缺测码
valid_range	物理量有效区间。陆表温度无此属性时按 0～900 K

产品	文件变量
olr	OLR
qpe	Precipitation（也认 QPE）
clm	CLM
fhs	FHS
lst	LST
snc	SNC
bsa	Albedo_BSA_SW
wsa	Albedo_WSA_SW

LSA 一份两列，一次 parse 只出 bsa 或 wsa。行列下标的标称投影阵不进本格式。也可传打包，解开再认 HDF5。

---

向外长波辐射

向外长波辐射（示例）

通过绘制经纬格网色斑，用来看向外长波辐射。产品 key 为 olr，单位 W/m²。本产品能绘制。

文件

FY-4B AGRI L2「向外长波辐射」（官方标识 OLR）。国内交换名 Z_SATE_*_FY4B-_AGRI--_*_L2-_OLR_*.NC。须带经纬坐标的 .NC。format: 'nc'，product: 'olr'。

数据

文件规则见页头。本产品变量是向外长波辐射，单位 W/m²。低于 80 或缺测铺色透明。

调用

const parsed = await parse(buffer, {
    format: 'nc',
    // 一次只出这一列
    product: 'olr'
})
const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'olr',
    // 示例页默认渐变填色
    fill: 'gradient'
})
layer.addTo(map)

当前场四至：layer.getBounds()，套合视野由调用侧做。见 图层。

色标

默认分档。低于 80 或缺测透明。

档 (W/m²)	80	120	160	200	240	280	320	360	400
色	rgb(255, 255, 255)	rgb(180, 240, 255)	rgb(80, 180, 230)	rgb(40, 160, 80)	rgb(220, 230, 60)	rgb(250, 180, 40)	rgb(240, 90, 20)	rgb(180, 20, 20)	rgb(90, 0, 20)

能力

绘制 cells / isobands / gradient 互斥。示例页默认渐变填色。

// 示例页默认渐变
fill: 'gradient'
// 切逐格 / 等值面
layer.setFill('cells')
layer.setFill('isobands')

对照 向外长波辐射示例。

数据裁剪 setClipPath 按省界贴边。clipField 只给导出 / 统计，不要把格心 NaN 场喂给图层。细写见 数据裁剪。对照 裁剪示例。

---

定量降水估计

定量降水估计（示例）

通过绘制经纬格网色斑，用来看定量降水估计。产品 key 为 qpe，单位 mm/h。文件变量 Precipitation，记录列名 qpe。本产品能绘制。

文件

FY-4B AGRI L2「定量降水估计」（官方标识 QPE）。国内交换名 Z_SATE_*_L2-_QPE_*.NC。product: 'qpe'。

数据

文件规则见页头。文件变量是 Precipitation，出口列名 qpe，单位 mm/h。低于 0.1 或缺测铺色透明。示例场按同一份 GANSU OLR 格点对格点推：半成品该时次全是 0，不是该时次官方 QPE。

调用

const parsed = await parse(buffer, {
    format: 'nc',
    // 一次只出这一列
    product: 'qpe'
})
const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'qpe',
    // 示例页默认渐变填色
    fill: 'gradient'
})

色标

档 (mm/h)	0.1	1	2	5	10	15	20	30	50
色	rgb(166, 242, 143)	rgb(61, 186, 61)	rgb(97, 184, 255)	rgb(0, 0, 225)	rgb(250, 0, 250)	rgb(128, 0, 64)	rgb(255, 170, 0)	rgb(255, 0, 0)	rgb(153, 0, 0)

能力

绘制 cells / isobands / gradient 互斥。示例页默认渐变填色。低于 0.1 透明。

// 示例页默认渐变
fill: 'gradient'
// 切逐格 / 等值面
layer.setFill('cells')
layer.setFill('isobands')

对照 定量降水估计示例。

---

云掩膜

云掩膜（示例）

通过绘制分类色斑，用来看云掩膜。产品 key 为 clm。本产品能绘制，只认逐格。

文件

FY-4B AGRI L2「云掩膜」（官方标识 CLM）。product: 'clm'。

数据

文件规则见页头。本产品变量是云掩膜类号。只认逐格，不插值。

调用

const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'clm'
})

色标

档	0	1	2	3
色	rgb(180, 210, 255)	rgb(120, 170, 230)	rgb(80, 120, 180)	rgb(40, 60, 110)

能力

绘制 只认逐格。类号不插值，不要切等值面或渐变。

对照 云掩膜示例。

---

火点

火点（示例）

通过绘制火点色斑，用来看热源点检测。产品 key 为 fhs。只铺类号 10，其余透明，不插值。本产品能绘制，只认逐格。

文件

FY-4B AGRI L2「热源点检测」（官方标识 FHS）。product: 'fhs'。

数据

文件规则见页头。本产品变量是热源点检测类号。只铺 10（火点），陆地 / 沙漠 / 云等其余类号透明。只认逐格，不插值。

调用

const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'fhs'
})

色标

只铺火点。

档	10 火点
色	rgb(255, 40, 0)

能力

绘制 只认逐格。类号不插值，不要切等值面或渐变。

对照 火点示例。

---

陆表温度

陆表温度（示例）

通过绘制经纬格网色斑，用来看陆表温度。产品 key 为 lst。parse 出口是 K，默认按 K 画。65533 等是云/海/冰/太空码，不上色。本产品能绘制。

文件

FY-4B AGRI L2「陆表温度」（官方标识 LST）。product: 'lst'。

数据

文件规则见页头。本产品变量是陆表温度，单位 K。有效区间 0～900 K。存储值 999 / 65529 / 65531 / 65533 / 65535 写成缺测。

调用

const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'lst',
    // 示例页默认渐变填色
    fill: 'gradient'
})

色标

档 (K)	250	260	270	280	290	300	310	320	330
色	rgb(7, 30, 120)	rgb(48, 106, 199)	rgb(116, 163, 226)	rgb(153, 205, 208)	rgb(234, 219, 112)	rgb(242, 155, 0)	rgb(231, 75, 26)	rgb(194, 0, 3)	rgb(120, 0, 20)

能力

绘制 cells / isobands / gradient 互斥。示例页默认渐变填色。

// 示例页默认渐变
fill: 'gradient'
// 切逐格 / 等值面
layer.setFill('cells')
layer.setFill('isobands')

对照 陆表温度示例。

---

积雪覆盖

积雪覆盖（示例）

通过绘制积雪色斑，用来看积雪覆盖。产品 key 为 snc。只铺类号 200，其余透明，不插值。本产品能绘制，只认逐格。

文件

FY-4B AGRI L2「积雪覆盖」（官方标识 SNC）。product: 'snc'。

数据

文件规则见页头。本产品变量是积雪覆盖类号。只铺 200（雪），陆地 / 云等其余类号透明。只认逐格，不插值。

调用

const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'snc'
})

色标

只铺雪。

档	200 雪
色	rgb(100, 200, 255)

能力

绘制 只认逐格。类号不插值，不要切等值面或渐变。

对照 积雪覆盖示例。

---

短波黑空反照率

短波黑空反照率（示例）

通过绘制经纬格网色斑，用来看短波黑空反照率。产品 key 为 bsa。文件变量 Albedo_BSA_SW，记录列名 bsa。与 wsa 同一份 LSA，解析时写 product: 'bsa'。本产品能绘制。

文件

FY-4B AGRI L2「陆表反照率」（官方标识 LSA）。国内交换名 Z_SATE_*_L2-_LSA_*.NC。product: 'bsa'。

数据

文件规则见页头。文件变量是 Albedo_BSA_SW，出口列名 bsa。存储值为负写成缺测。原件常是 0～1000 整型，已是 0～1 浮点则不再除。

调用

const parsed = await parse(buffer, {
    format: 'nc',
    // 一次只出这一列
    product: 'bsa'
})
const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'bsa',
    // 示例页默认渐变填色
    fill: 'gradient'
})

色标

与白空反照率共用。

档	0	0.1	0.2	0.3	0.4	0.5	0.6	0.7	0.8
色	rgb(20, 40, 80)	rgb(40, 90, 160)	rgb(70, 150, 120)	rgb(180, 200, 90)	rgb(230, 190, 60)	rgb(240, 140, 30)	rgb(220, 70, 20)	rgb(180, 20, 20)	rgb(120, 0, 40)

能力

绘制 cells / isobands / gradient 互斥。示例页默认渐变填色。

// 示例页默认渐变
fill: 'gradient'
// 切逐格 / 等值面
layer.setFill('cells')
layer.setFill('isobands')

对照 短波黑空反照率示例。

---

短波白空反照率

短波白空反照率（示例）

通过绘制经纬格网色斑，用来看短波白空反照率。产品 key 为 wsa。文件变量 Albedo_WSA_SW，记录列名 wsa。本产品能绘制。

文件

同一份 LSA。product: 'wsa'。

数据

文件规则见页头。文件变量是 Albedo_WSA_SW，出口列名 wsa。编码与黑空反照率相同，色标共用。

调用

const parsed = await parse(buffer, {
    format: 'nc',
    // 一次只出这一列
    product: 'wsa'
})
const layer = createQuantLayer({
    // 解析出口
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'wsa',
    // 示例页默认渐变填色
    fill: 'gradient'
})

色标

与黑空反照率同一套。

能力

绘制 cells / isobands / gradient 互斥。示例页默认渐变填色。

// 示例页默认渐变
fill: 'gradient'
// 切逐格 / 等值面
layer.setFill('cells')
layer.setFill('isobands')

对照 短波白空反照率示例。