HydrologySimulation

new Cesium.HydrologySimulation(options)

应急管理部灾害应急研究院水动力淹没模拟模型可视化功能.
支持三种模拟模式SimulationRange.
支持两类效果:
水面波动效果或者指定字段应用色带着色效果。从色带效果切换到水面波动效果直接启用 HydrologySimulation#isWater即可。
水面波动效果切换到色带着色效果,应当指定 HydrologySimulation#colorRampPropertyName,同时禁用 HydrologySimulation#isWater.
Name Type Description
options Object 具有如下属性
Name Type Default Description
viewer Viewer viewer.
simulationRange SimulationRange SimulationRange.
url SimulationRange HydrologySimulation.json文件资源描述,所在文件夹下有序号子文件夹内存放3D Tiles数据,有HotMap文件夹放置序号.hm文件.
isWater Boolean true optional 是否使用水面波动效果.
waterColor Color Color.fromBytes(25, 116, 166, 128) optional 对应水面波动效果的融合颜色.
multiply Number 1 optional 倍速.
hotmap Boolean false optional 是否启用热图进行模拟播放.优先级比 HydrologySimulation#isWater高.当该属性设置为false是,切换HydrologySimulation#isWater才能生效.
colorRampPropertyName String optional 色带效果所依据的字段名称.
colorRamp Array.<Color> optional 色带描述数组.默认 HydrologySimulation#defaultColorRamp.
smooth Boolean true optional 热力图是否平滑(否则格子形式着色)

Members

static Cesium.HydrologySimulation.defaultColorRamp : Array.<string>

色带着色效果默认色带数组.
Default Value: ["color('#5EB300')", "color('#BBD300')", "color('#E3E500')", "color('#FEF200')", "color('#FFC002')", "color('#FD8400')", "color('#FF6000')", "color('#FE3A00')", "color('#FF1700')", "color('#D61400')", "color('#F925FE')"]
色带效果所依据的属性名称。
结束时刻,来自元数据的json描述.来自元数据的json描述.
是否启用热图进行模拟播放.优先级比 HydrologySimulation#isWater高.当该属性设置为false是,切换HydrologySimulation#isWater才能生效
热图色彩映射区间。x对应最小值,y对应最大值.
最大值最小值设置时应当取值在hydrologySimulation._metaInfo.Dimensions["Depth"].Min 到 hydrologySimulation._metaInfo.Dimensions["Depth"].Max之间
Example:
强制修改着色区间,应当
hydrologySimulation.hotmapRange.x = 0;
hydrologySimulation.hotmapRange.y = 2.1;
guid,数据处理过程标记,为空则解析时创建以"cesium"开头的guid.
时刻间隔时长,单位为秒,来自元数据的json描述.
是否应用水面波动效果。优先级低,仅在hotmap为false时生效.isWater设置为false加载3DTiles显示为色带效果,为true时加载3DTiles显示为水面波动效果.
模拟的时间倍速。取值0.0 - 1.0将放慢,大于1.0将加速。
例如:
假设:HydrologySimulation#physicalSeconds 为200秒,设置当前倍速参数为200,则该次模拟将在1秒内播放完.
假设:HydrologySimulation#intervalTime 为200秒,设置当前倍速参数为200,则该次模拟将在每隔1秒更新一次数据.

readonly physicalSeconds : String

模拟数据的物理时长,秒为单位,从元数据计算得到.
模拟进度,为0.0-1.0之间的小数.不推荐自行写入。
数据的区域范围(矩形),仅针对元数据版本0.2及以上支持
标记是否已解析完元数据,在HydrologySimulation#readyPromise触发前更新为true
Default Value: false
解析完元数据的异步对象
模式,参考SimulationRange
热力图是否平滑(否则格子形式着色)
初始时刻时间,来自元数据的json描述.
步总数,即模拟时刻的总个数,int型.来自元数据的json描述.

readonly supportedColorRampProperty : Array.<String>

支持设置为色带效果的属性名称,从元数据计算得到.
透明度,只针对水面波动效果有效。取值范围[0.0-1.0],初始值为构造函数中参数:waterColor的alpha.
数据更新事件
Example:
hydrologySimulation.updateEvent.addEventListener(function(theSimulation) {
  // theSimulation._currentStepIndex 内部私有变量,最大等于hydrologySimulation.stepCount-1.不建议操作该变量.
  document.getElementById("msg").innerText = "当前进度:\t" + theSimulation.rate.toFixed(4).toString() +
                                             "\n使用第:\t" + theSimulation._currentStepIndex + "\t数据";
})
模拟数据的根描述地址,不支持重设

Methods

继续播放,对应 HydrologySimulation#pause.
销毁对象资源,执行前应调用 HydrologySimulation#isDestroyed函数进行检查。
当前对象资源释放(销毁后), HydrologySimulation#isDestroyed返回值为true.
Returns:
判断是否已经被销毁
Returns:
载入统计类型的单个hmz文件。可以通过hotmapRange去手动调整着色区间,入参时不支持传入可避免名词概念的的混淆
Name Type Description
hmzUrl hmz文件
暂停播放,对应 HydrologySimulation#continue.
从头开始播放模拟,对应 HydrologySimulation#stop.
结束播放模拟,对应 HydrologySimulation#start.
Need help? The fastest way to get answers is from the community and team on the Cesium Forum.