经纬格网 · 产品能力clipField

地面分析、组网、通道图、定量、ERA5 单列填色、风场和天气雷达平面 / 射线都能按多边形收场。从各产品的「能力」进入。clipField 收 rows / cols，界外写成 NaN，只改记录，不读文件。显示裁走实例 setClipPath。对照着图看：地面分析、组网、通道图、定量、ERA5、风场、雷达平面、雷达射线。测风、风暴不开放。

调用

import { clipField, createFieldLayer } from '@dingnl/ltvis-globe/layer'

const clipped = clipField(parsed.values, {
    // 要裁的列，与 parse 相同
    product: 'tem',
    boundary
})
const layer = createFieldLayer({
    // 铺色用原场，不要把 clipField 的 NaN 场喂给图层
    data: parsed.values,
    // 画哪一列，与 parse 相同
    product: 'tem'
})
layer.addTo(globe)
// 贴边，不改记录
layer.setClipPath(boundary)

clipField 改数值：界外格子写成 NaN，数组变短。格心在面内才留。这只给导出 / 统计。setClipPath 按省界贴边，不改记录。identify / 提示框：落点在 setClipPath 面外，或该格已是 NaN，都返回空。getBounds() 有贴边时是裁剪区域与场的相交框；取消裁剪或没贴边时仍是整场记录框。clipField 后用 setOption 换记录，四至也跟着变。铺色必须用未打孔的原场。取消裁剪时 setClipPath(null)，记录不用换。

参数

字段	说明
product	要裁的列名，与 parse 的 product 相同。例如 tem、pre、hail、rh
boundary	GeoJSON Polygon / MultiPolygon / LineString / MultiLineString / Feature / FeatureCollection，或 [{ lon, lat }] 环数组。闭合线划按面收，只并、不挖

边界和格网不相交、或面内没有格心，会报错。换边界只需重跑 clipField，不必重新解析文件。