overlapDevices.js 7.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184
  1. /**
  2. * 重叠设备聚合与展开(票 45;规格 17 / 决策票 11)。
  3. *
  4. * 纯函数、不碰 Cesium/Vue/DOM:
  5. * - 只对同一监测点、当前可逐台绘制的设备做重叠分组;
  6. * - K = 当前可逐台绘制数,N = 快照关联总数;不可绘制设备不混入 K;
  7. * - 聚合符号没有 deviceCode,展开子点才带 deviceCode;
  8. * - 展开位置是屏幕渲染层数据,不写回经纬度。
  9. */
  10. import { deviceVisualForStatus } from './deviceStatus.js'
  11. export const OVERLAP_STATE = {
  12. COLLAPSED: 'collapsed',
  13. EXPANDED: 'expanded',
  14. DEGRADED: 'degraded',
  15. SELECTED: 'selected',
  16. }
  17. export const DEFAULT_MAX_FAN = 10
  18. export const DEFAULT_OVERLAP_METERS = 1.5
  19. const EARTH_LAT_METERS = 110540
  20. const EARTH_LON_METERS = 111320
  21. function metersBetween(a, b) {
  22. if (!a || !b || ![a.longitude, a.latitude, b.longitude, b.latitude].every(Number.isFinite)) return Infinity
  23. const lat = ((a.latitude + b.latitude) / 2) * Math.PI / 180
  24. const dx = (b.longitude - a.longitude) * EARTH_LON_METERS * Math.cos(lat)
  25. const dy = (b.latitude - a.latitude) * EARTH_LAT_METERS
  26. return Math.hypot(dx, dy)
  27. }
  28. function safeMaxFan(value) {
  29. return Number.isFinite(value) && value >= 1 ? Math.floor(value) : DEFAULT_MAX_FAN
  30. }
  31. function statusPriority(row) {
  32. const visual = deviceVisualForStatus(row && row.status)
  33. return Number.isFinite(visual.priority) ? visual.priority : 999
  34. }
  35. /** 当前设备行能否算进 K。placement 已由票 42/46 判好,聚合层不重新判坐标。 */
  36. export function isFanCandidate(row) {
  37. return Boolean(row && row.placement === 'drawn' &&
  38. Number.isFinite(row.longitude) && Number.isFinite(row.latitude))
  39. }
  40. /**
  41. * 把设备按点位和近距离分成重叠组。
  42. * 非候选设备留在 `excluded`,不进入 K。
  43. */
  44. export function groupOverlappingDevices(rows, { overlapMeters = DEFAULT_OVERLAP_METERS, maxFan = DEFAULT_MAX_FAN, total = null } = {}) {
  45. const candidates = (Array.isArray(rows) ? rows : []).filter(isFanCandidate)
  46. const excluded = (Array.isArray(rows) ? rows : []).filter((row) => !isFanCandidate(row))
  47. const groups = []
  48. const threshold = Number.isFinite(overlapMeters) && overlapMeters >= 0 ? overlapMeters : DEFAULT_OVERLAP_METERS
  49. for (const row of candidates) {
  50. let target = null
  51. for (const group of groups) {
  52. if (group.pointCode !== row.pointCode) continue
  53. if (group.rows.some((existing) => metersBetween(existing, row) <= threshold)) {
  54. target = group
  55. break
  56. }
  57. }
  58. if (!target) {
  59. target = { pointCode: row.pointCode || '', rows: [] }
  60. groups.push(target)
  61. }
  62. target.rows.push(row)
  63. }
  64. const planned = groups.map((group) => {
  65. const item = planOverlapGroup(group.rows, { maxFan })
  66. item.n = Number.isFinite(total) ? total : item.k
  67. return item
  68. })
  69. // 排除项是清单/降级口径,不是一个可展开的聚合组;附着元数据但不污染 groups.length。
  70. planned.excluded = excluded
  71. return planned
  72. }
  73. function planOverlapGroup(rows, { maxFan = DEFAULT_MAX_FAN } = {}) {
  74. const list = Array.isArray(rows) ? rows.slice() : []
  75. const k = list.length
  76. const highest = list.slice().sort((a, b) => statusPriority(a) - statusPriority(b))[0] || null
  77. const threshold = safeMaxFan(maxFan)
  78. const degraded = k > threshold
  79. return {
  80. key: `${list[0] && list[0].pointCode ? list[0].pointCode : ''}|${list.map((row) => row.code).join(',')}`,
  81. pointCode: list[0] ? list[0].pointCode || '' : '',
  82. rows: list,
  83. k,
  84. n: k,
  85. maxFan: threshold,
  86. degraded,
  87. state: degraded ? OVERLAP_STATE.DEGRADED : OVERLAP_STATE.COLLAPSED,
  88. visual: highest ? {
  89. key: highest.status || 'UNKNOWN',
  90. status: highest.status || '',
  91. tone: deviceVisualForStatus(highest.status).tone,
  92. shape: deviceVisualForStatus(highest.status).shape,
  93. label: deviceVisualForStatus(highest.status).label,
  94. } : null,
  95. label: degraded
  96. ? `${k} 台设备(本屏显示 ${threshold} 台 / 其余见清单)`
  97. : `${k} 台设备`,
  98. }
  99. }
  100. /** 一个点位关联总数 N,包含当前快照清单中的全部设备编码;不把 N 冒充为 K。 */
  101. export function overlapCount({ groups = [], total = 0 } = {}) {
  102. const k = (Array.isArray(groups) ? groups : []).reduce((sum, group) => sum + (group.k || 0), 0)
  103. return { k, n: Number.isFinite(total) ? total : k }
  104. }
  105. /** 聚合组静止态摘要:没有 deviceCode,不能被设备拾取链选中。 */
  106. export function aggregateMarker(group) {
  107. if (!group || !group.rows || !group.rows.length) return null
  108. return {
  109. kind: 'monitoring-device-overlap',
  110. pointCode: group.pointCode,
  111. code: '',
  112. deviceCode: '',
  113. k: group.k,
  114. n: group.n,
  115. state: group.state,
  116. degraded: group.degraded,
  117. label: group.label,
  118. visual: group.visual,
  119. }
  120. }
  121. /** hover 预览、click 固定展开;点子设备转为持续可见的选中入口。 */
  122. export function transitionOverlapState(state, action) {
  123. const current = state || OVERLAP_STATE.COLLAPSED
  124. if (action === 'hover-enter' && [OVERLAP_STATE.COLLAPSED, OVERLAP_STATE.SELECTED, OVERLAP_STATE.DEGRADED].includes(current)) return OVERLAP_STATE.EXPANDED
  125. if (action === 'hover-leave' && current === OVERLAP_STATE.EXPANDED) return OVERLAP_STATE.COLLAPSED
  126. if (action === 'aggregate-click' && current !== OVERLAP_STATE.EXPANDED) return OVERLAP_STATE.EXPANDED
  127. if (action === 'device-click') return OVERLAP_STATE.SELECTED
  128. if (['blank-click', 'back-to-point', 'close'].includes(action)) return OVERLAP_STATE.COLLAPSED
  129. return current
  130. }
  131. /**
  132. * 生成环/扇形的屏幕位置。输入/输出都是渲染层位置,不含/不改经纬度。
  133. * K>maxFan 只返回前 maxFan 台逐台展开,其余仍留在清单。
  134. */
  135. export function fanLayout(group, { center = { x: 0, y: 0 }, radius = 42, startAngle = -Math.PI / 2 } = {}) {
  136. const list = group && Array.isArray(group.rows) ? group.rows : []
  137. const limit = Math.min(list.length, safeMaxFan(group && group.maxFan))
  138. const visible = list.slice(0, limit)
  139. return visible.map((row, index) => {
  140. const angle = startAngle + (Math.PI * 2 * index) / Math.max(visible.length, 1)
  141. return {
  142. kind: 'monitoring-device',
  143. code: row.code,
  144. deviceCode: row.code,
  145. pointCode: row.pointCode,
  146. x: center.x + Math.cos(angle) * radius,
  147. y: center.y + Math.sin(angle) * radius,
  148. // 仅屏幕坐标;保留真实位置字段供身份/引线使用,但不改它。
  149. longitude: row.longitude,
  150. latitude: row.latitude,
  151. }
  152. })
  153. }
  154. /** 设备优先:聚合符号没有设备身份,展开子点才可被普通 pick 认出。 */
  155. export function resolveOverlapPick({ aggregateHit = null, deviceHit = null, pointHit = null } = {}) {
  156. // 注意引擎 `pickDeviceMarkerAt` 回的是 `{ kind, code, pointCode, status }` —— 身份字段是
  157. // **code**(与票 43 的 resolvePickOrder 同一形状)。这里用 (code || deviceCode) 认设备,
  158. // 避免把"引擎回 code、这里查 deviceCode"的字段名不一致写成恒 false(本票真机走查抓到)。
  159. if (deviceHit && (deviceHit.code || deviceHit.deviceCode)) return { target: 'device', pick: deviceHit }
  160. if (aggregateHit) return { target: 'overlap', pick: aggregateHit }
  161. if (pointHit) return { target: 'point', pick: pointHit }
  162. return { target: 'none', pick: null }
  163. }
  164. /** 展开态结束条件。 */
  165. export function shouldCollapseOverlap(action) {
  166. return ['blank-click', 'back-to-point', 'close'].includes(action)
  167. }