@mapcatch/util 1.0.15 → 2.0.0

package/src/util.js

@@ -5,49 +5,84 @@ import cameras from './constants/cameras'
 import {getType, distance as calcDistance, midpoint as getMidpoint} from '@turf/turf'
 import { layerGroups } from './constants'
 import { mat4 } from 'gl-matrix'
-import { crsList, crsTypes } from './constants'
+import {transformCoordinateToLngLat, project} from './transform'
+import * as turf from '@turf/turf'
 
-export function generateId() { // 生成随机id
+/**
+ * 生成uuid随机字符串
+ * @returns uuid字符串
+ */
+export function generateId () { // 生成随机id
   return uuidv4()
 }
-export function formatDate(date) {
+
+/**
+ * 将给定的日期格式化
+ * @param {*} date 
+ * @returns 
+ */
+export function formatDate (date) {
   if (!date) {
     return '-'
   }
   return moment(date).format('YYYY-MM-DD HH:mm:ss')
 }
-export function formatLocalDate() {
+
+/**
+ * 另一种日期格式化
+ * @returns 
+ */
+export function formatLocalDate () {
   return moment().format('YYYY/M/D HH:mm:ss')
 }
-export function formatFileSize (value) { // 文件大小格式化，自动换算kb\mb\gb
+
+/**
+ * 将文件大小格式化，自动换算kb\mb\gb
+ * @param {*} value 文件大小，单位“字节”
+ * @returns 
+ */
+export function formatFileSize (value) {
   value = parseInt(value)
-  value = value.toString()
-  const length = value.length
-  if (length > 6) {
-    value = (Number(value) / 1000000).toFixed(2)
-    return value + ' MB'
-  } else {
-    value = (Number(value) / 1000).toFixed(2)
-    return value + ' KB'
-  }
+  let level = Math.floor(Math.log(value) / Math.log(1024))  // 整数部分
+  let units = ['B', 'KB', 'MB', 'GB', 'TB', 'PB']
+  return _.round(value / Math.pow(1024, level), 2) + units[level] 
 }
-export function getGeoCoordOperator(flag) { // 将照片的中的经纬度方位字母换成正负号
+
+/**
+ * 根据exif中的经纬度标志判断正负号
+ * @param {*} flag 
+ * @returns 
+ */
+export function getGeoCoordOperator (flag) { // 将照片的中的经纬度方位字母换成正负号
   if (flag === 'N' || flag === 'E') {
     return 1
   }
   return -1
 }
-export function toRadian(arr) { // 度分秒转弧度
+
+/**
+ *  度分秒转弧度
+ * @param {*} arr 度分秒数组
+ * @returns 
+ */
+export function toRadian (arr) {
   return arr[0] + (arr[1] / 60) + (arr[2] / 3600)
 }
-export function diffLayers(newList, oldList = []) { // 任务详情中的任务成果树进行差异计算，获取图层更新的操作
+
+/**
+ * 任务详情中的任务成果树进行差异计算，获取图层更新的操作
+ * @param {*} newList 
+ * @param {*} oldList 
+ * @returns 
+ */
+export function diffLayers (newList, oldList = []) {
   newList = _formatTree(newList)
   oldList = _formatTree(oldList)
   let cmds = []
   for(let group of newList) {
     let {visible: groupVisible} = group
     for(let layer of group.items || []) {
-      let {id, type, opacity, visible, color, geometry} = layer
+      let {id, type, opacity, visible} = layer
       if (!groupVisible) {
         visible = false
       }
@@ -76,7 +111,7 @@ export function diffLayers(newList, oldList = []) { // 任务详情中的任务
       } else if (opacity !== oldOpacity || (!_.isEqual(layer.metadata, oldNode.metadata))) {
         cmds.push(['updateLayer', layer])
       } else if (visible !== oldVisible){
-        cmds.push([visible?'addLayer':'removeLayer', layer])
+        cmds.push([visible ? 'addLayer' : 'removeLayer', layer])
       }
     }
   }
@@ -95,7 +130,14 @@ export function diffLayers(newList, oldList = []) { // 任务详情中的任务
   }
   return cmds
 }
-export function findNodeInTree(id, tree) { // 从图层树中查找指定
+
+/**
+ * 从图层树结构中查找指定id的节点
+ * @param {*} id 需要查找的节点id
+ * @param {*} tree 图层树
+ * @returns 
+ */
+export function findNodeInTree (id, tree) { // 从图层树中查找指定
   for(let node of tree) {
     if (node.id === id) {
       return node
@@ -109,7 +151,7 @@ export function findNodeInTree(id, tree) { // 从图层树中查找指定
   }
   return null
 }
-function _formatTree(treeList) {
+function _formatTree (treeList) {
   let tree = _.cloneDeep(treeList)
   for(let group of tree) {
     for(let layer of group.items || []) {
@@ -120,7 +162,13 @@ function _formatTree(treeList) {
   }
   return tree
 }
-// 获取比当前图层，层级更低的图层id
+
+/**
+ * 在mapbox中获取即将插入图层的位置，根据图层metadata中的图层类型来确定图层顺序
+ * @param {*} map 当前地图对象
+ * @param {*} layer 即将插入的图层
+ * @returns 
+ */
 export function getBeforeId (map,layer){
   let layersForFilter = map.style._layers
   let orders = map.style.order
@@ -166,14 +214,26 @@ export function getBeforeId (map,layer){
     return level
   }
 }
-export function isTokenExpired(response) {
+
+/**
+ * 判断当前响应是否为token过期
+ * @param {*} response 
+ * @returns 
+ */
+export function isTokenExpired (response) {
   if (!response) {
     return false
   }
-  let {message = '', msg =''} = response.data
+  let {message = '', msg = ''} = response.data
   return response.status == 401 && (msg.toLowerCase().includes('expired') || message.toLowerCase().includes('expired'))
 }
-export function getDataType(model) { // 根据相机型号获取照片的类型
+
+/**
+ * 根据相机型号获取照片的类型
+ * @param {*} model 相机型号
+ * @returns 
+ */
+export function getDataType (model) {
   for(let type in cameras) {
     if (cameras[type].includes(model)) {
       return type
@@ -181,7 +241,12 @@ export function getDataType(model) { // 根据相机型号获取照片的类型
   }
   return 'normal'
 }
-export function downloadImage(base64) {
+
+/**
+ * 下载base64格式的图像快照
+ * @param {*} base64 
+ */
+export function downloadImage (base64) {
   let filename = `快照${moment().format('YYYYMMDD')}${new Date().getTime()}.png`
   let a = document.createElement('a')
   a.href = base64
@@ -190,7 +255,13 @@ export function downloadImage(base64) {
   a.click()
   document.body.removeChild(a)
 }
-export function getGeometryType(feature) {
+
+/**
+ * 获取geojon要素的几何类型
+ * @param {*} feature 
+ * @returns point/line/polygon
+ */
+export function getGeometryType (feature) {
   let type = getType(feature)
   if (['Point', 'MultiPoint'].includes(type)) {
     return 'point'
@@ -200,14 +271,26 @@ export function getGeometryType(feature) {
     return 'polygon'
   }
 }
-export function rgbaToFloat(v) {
+
+/**
+ * 将png图片中一个像素（四字节的数组）转为float32浮点数
+ * @param {*} v 
+ * @returns 
+ */
+export function rgbaToFloat (v) {
   let a = v[3] > 128.0 ? 0 : 1
-  let sign = -1 * (1 - a) + a;
-  let expo = Math.floor((v[3] + 0.1) % 128.0) * 2.0 + Math.floor((v[2] + 0.1) / 128.0) - 127.0;
-  let sig = v[0] + v[1] * 256.0 + Math.floor((v[2] + 0.1) % 128.0) * 256.0 * 256.0;
-  return sign * (1.0 + sig / 8388607.0) * Math.pow(2.0, expo);
+  let sign = -1 * (1 - a) + a
+  let expo = Math.floor((v[3] + 0.1) % 128.0) * 2.0 + Math.floor((v[2] + 0.1) / 128.0) - 127.0
+  let sig = v[0] + v[1] * 256.0 + Math.floor((v[2] + 0.1) % 128.0) * 256.0 * 256.0
+  return sign * (1.0 + sig / 8388607.0) * Math.pow(2.0, expo)
 }
-export function getAnnotationFeature(annotationItem) {
+
+/**
+ * 将标注的数据库对象转为GeoJSON对象
+ * @param {*} annotationItem 
+ * @returns 
+ */
+export function getAnnotationFeature (annotationItem) {
   let {geometry} = annotationItem
   let properties = _.cloneDeep(annotationItem)
   delete properties.geometry
@@ -218,7 +301,14 @@ export function getAnnotationFeature(annotationItem) {
     geometry: _.cloneDeep(geometry)
   }
 }
-export function getAnnotationName(annotations, type) {
+
+/**
+ * 根据已有的标注列表计算一个默认的标注名称，确保名称唯一
+ * @param {*} annotations 当前已有的标注列表
+ * @param {*} type 标注类型
+ * @returns 
+ */
+export function getAnnotationName (annotations, type) {
   let indexs = []
   let name = type === 'point' ? '点注记' : (type === 'line' ? '线注记' : '面注记')
   annotations.forEach(item => {
@@ -233,7 +323,7 @@ export function getAnnotationName(annotations, type) {
       }
     }
   })
-  indexs = indexs.sort((a, b) => a-b)
+  indexs = indexs.sort((a, b) => a - b)
   for(let i = 0;i < indexs.length;i++) {
     if (indexs[i] !== i) {
       return i === 0 ? name : `${name} ${i}`
@@ -241,19 +331,25 @@ export function getAnnotationName(annotations, type) {
   }
   return indexs.length === 0 ? name : `${name} ${indexs.length}`
 }
-export function getLineLabelFeature(lineFeature) {
+
+/**
+ * 计算线要素标注的文字注记绘制的位置和方向
+ * @param {*} lineFeature 
+ * @returns 返回一个GeoJSON点要素，其集合属性中是文字标注的位置，要素属性中是标注的方向
+ */
+export function getLineLabelFeature (lineFeature) {
   let coordinates = lineFeature.geometry.coordinates
   let temps = []
   for(let i = 1;i < coordinates.length;i++) {
-    let distance = calcDistance(coordinates[i-1], coordinates[i], {units: 'meters'})
+    let distance = calcDistance(coordinates[i - 1], coordinates[i], {units: 'meters'})
     if (distance > 30) {
-      temps.push([coordinates[i-1], coordinates[i]])
+      temps.push([coordinates[i - 1], coordinates[i]])
     }
   }
   let labelLine = []
   if (!temps.length) {
     let mid = Math.floor(coordinates.length / 2 - 1)
-    labelLine = [coordinates[mid], coordinates[mid+1]]
+    labelLine = [coordinates[mid], coordinates[mid + 1]]
   } else {
     let mid = Math.floor(temps.length / 2)
     labelLine = temps[mid]
@@ -267,15 +363,12 @@ export function getLineLabelFeature(lineFeature) {
   midPoint.geometry.coordinates.push(((labelLine[0][2] || 0) + (labelLine[1][2] || 0)) / 2)
   return midPoint
 }
-export function project(lngLat, zoom=12) { // 经纬度转墨卡托像素坐标
-  let [lng, lat] = lngLat
-  let x = (180 + lng) / 360
-  let y = (180 - (180 / Math.PI) * Math.log(Math.tan(Math.PI / 4 + (lat * Math.PI) / 360))) / 360
-  return {
-    x: x * Math.pow(2, zoom) * 512,
-    y: y * Math.pow(2, zoom) * 512
-  }
-}
+
+/**
+ * 将图标文件当作mapbox地图的符号添加到地图对象
+ * @param {*} map 当前地图对象
+ * @param {*} icons 要添加的图标列表，包含图标的url以及是否作为sdf符号
+ */
 export function addIcons2Map (map, icons) {
   icons.forEach(({url, sdf}) => {
     map.loadImage(url, (error, image) => {
@@ -287,7 +380,14 @@ export function addIcons2Map (map, icons) {
   })
 }
 
-export function getTaskTreeList(taskInfo, annotations, layers) {
+/**
+ * 构造任务成果树的结构
+ * @param {*} taskInfo 
+ * @param {*} annotations 
+ * @param {*} layers 
+ * @returns 
+ */
+export function getTaskTreeList (taskInfo, annotations, layers) {
   let groups = _.cloneDeep(taskInfo.metadata?.groups || layerGroups)
   groups.forEach(g => g.items = [])
   annotations.forEach(item => {
@@ -310,6 +410,11 @@ export function getTaskTreeList(taskInfo, annotations, layers) {
   return groups
 }
 
+/**
+ * 判断当前数组中是否包含非数值要素
+ * @param {*} arr 
+ * @returns 
+ */
 export function hasNaN (arr) {
   for (let i = 0; i < arr.length; i++) {
     if (Number.isNaN(arr[i])) {
@@ -319,6 +424,31 @@ export function hasNaN (arr) {
   return false
 }
 
+export function flatObject (obj) {
+  let arr = {}
+  for(let key in obj) {
+    if (key.startsWith('xmlns')) {
+      continue
+    }
+    if (Array.isArray(obj[key])) {
+      continue
+    }
+    if (typeof obj[key] === 'object') {
+      Object.assign(arr, flatObject(obj[key]))
+    } else {
+      arr[key] = obj[key]
+    }
+  }
+  return arr
+}
+
+/**
+ * 根据pry参数计算旋转矩阵
+ * @param {*} pitch 
+ * @param {*} roll 
+ * @param {*} yaw 
+ * @returns 
+ */
 export function getRotationMatrix (pitch, roll, yaw) {
   let orientation = []
   let enu2ned = mat4.fromValues(0, 1, 0, 0, 1, 0, 0, 0, 0, 0, -1, 0, 0, 0, 0, 1)
@@ -336,32 +466,198 @@ export function getRotationMatrix (pitch, roll, yaw) {
   return orientation
 }
 
-export function getWKTString(crs) {
-  let {type, epsg_code} = crs
-  for(let i = 0;i < crsList.length;i++) {
-    let typeCode = crsTypes[crsList[i].type].code
-    if (typeCode !== type) {
-      continue
-    }
-    let {authCode, wkt, children} = crsList[i]
-    if (authCode == epsg_code) {
-      return wkt
-    }
-    if (children?.length) {
-      for(let j = 0;j < children.length;j++) {
-        if (children[j].children) {
-          for(let n = 0;n < children[j].children.length;n++) {
-            if (children[j].children[n].authCode == epsg_code) {
-              return children[j].children[n].wkt
-            }
-          }
-        } else {
-          if (children[j].authCode == epsg_code) {
-            return children[j].wkt
-          }
-        }
+/**
+ * 将LocalENU坐标系的ROI转为经纬度
+ * @param {*} roi 带转换的roi结构
+ * @param {*} crs 目标坐标系，当前仅支持LocalENU
+ * @returns 
+ */
+export function transformRoi (roi, crs) {
+  let {boundary, min_z, max_z} = roi
+  let {type, origin_point} = crs
+  if (type === 0) { // LocalENU
+    let newBoundary = []
+    boundary.forEach(coord => {
+      let lla = transformCoordinateToLngLat([...coord, 0], crs)
+      newBoundary.push(lla)
+    })
+    min_z += origin_point[2]
+    max_z += origin_point[2]
+    return {boundary: newBoundary, min_z, max_z}
+  }
+  return roi // Local系，不做转换
+}
+
+/**
+ * 根据当前pos精度描述获得精度的具体数值
+ * @param {*} accurency 
+ * @returns 
+ */
+export function getPosSigma (accurency) {
+  if (accurency === 'high') {
+    return [0.03, 0.03, 0.06]
+  } else if (accurency === 'low') {
+    return [10, 10, 10]
+  } else {
+    return [1, 1, 1]
+  }
+}
+
+/**
+ * 根据照片列表中解析的pos，将照片列表转为GeoJSON
+ * @param {*} photoList 
+ * @returns 
+ */
+export function photoPos2Geojson (photoList) {
+  let features = []
+  let item = photoList.find(d => d.meta_data.pos)
+  if (item) {
+    let coordinate_system = _.cloneDeep(item.meta_data.coordinate_system)
+    photoList.forEach(photo => {
+      let {meta_data = {}} = photo
+      let {pos} = meta_data
+      let position = transformCoordinateToLngLat(pos, coordinate_system)
+      if (!position) {
+        return
       }
+      let properties = _.cloneDeep(photo)
+      properties.type = 'photo'
+      features.push(turf.point(position, properties))
+    })
+  }
+  
+  let geojson = turf.featureCollection(features)
+  let bbox = null
+  if (features.length) {
+    bbox = turf.bbox(geojson)
+  }
+  return {geojson, bbox}
+}
+
+export function getDistance (p1, p2) {
+  return Math.sqrt((p1[0] - p2[0]) * (p1[0] - p2[0]) + (p1[1] - p2[1]) * (p1[1] - p2[1]))
+}
+
+export function getMaxValue (arr, field) {
+  let value = -Infinity
+  arr.forEach(item => {
+    value = Math.max(item[field], value)
+  })
+  return value
+}
+
+export function getAverageValue (arr, field) {
+  let sum = 0
+  arr.forEach(item => {
+    sum += item[field]
+  })
+  return sum / arr.length
+}
+
+export function getAppVersion (taskInfo) {
+  let {appVersion, environment} = taskInfo.metadata
+  if (appVersion) {
+    return appVersion
+  }
+  if (environment) {
+    return `${environment.platform}(${environment.appVersion})`
+  }
+  return '暂无'
+}
+
+/**
+ * 将重建质量的数值转为名称
+ * @param {*} quality 重建质量-1/2/3
+ * @returns 
+ */
+export function getResolutionLevelByQuality (quality){
+  switch (quality) {
+    case 'low':
+      return 3
+    case 'high':
+      return 1
+    case 'medium':
+    default:
+      return 2
+  }
+}
+
+export function getQualityAliasByLevel (resolutionLevel) {
+  let alias = '高'
+  if (resolutionLevel === 1) {
+    alias = '超高'
+  } else if (resolutionLevel === 3) {
+    alias = '中'
+  }
+  return alias
+}
+
+/**
+ * 将数据类型的数值转字符串
+ * @param {*} dataType 
+ * @returns 
+ */
+export function getImageTypeByDataType (dataType){
+  switch (dataType) {
+    case 'normal':
+      return 1
+    case 'multispectral':
+      return 2
+    case 'infrared':
+    default:
+      return 3
+  }
+}
+
+export function getDataTypeAliasByImageType (type) {
+  if (type === 'infrared') {
+    return '热红外'
+  } else if (type === 'multispectral') {
+    return '多光谱'
+  } else {
+    return '可见光'
+  }
+}
+
+export function getTaskStatusAlias (status) {
+  if (status === 'complete') {
+    return '建模完成'
+  } else if (status === 'error') {
+    return '建模出错'
+  } else if (status === 'none') {
+    return '未开始'
+  } else if (status === 'waiting') {
+    return '正在排队'
+  } else if (status === 'aerotriangulation') {
+    return '空三完成'
+  } else if (status.startsWith('processing')){
+    return '正在处理'
+  } else if (status === 'stop'){
+    return '任务终止'
+  } else {
+    return '未知状态'
+  }
+}
+
+/**
+ * 根据重建参数的输出属性判断是否开启了3d建模
+ */
+export function include3d (output = []) {
+  if (output.length && output.includes('mesh3d')) {
+    return true
+  }
+  return false
+}
+
+export function extend (dest, ...sources) {
+  for (const src of sources) {
+    for (const k in src) {
+      dest[k] = src[k]
     }
   }
-  return null
-}
+  return dest
+}
+export function endsWith (string, suffix) {
+  return string.indexOf(suffix, string.length - suffix.length) !== -1
+}
+

package/CHANGELOG.md

@@ -1,60 +0,0 @@
-## v1.0.2
-
-- [fix] 修复图片解析报错的问题。
-
-## v1.0.3
-
-- [fix] 修复`util.formatDate(date)`日期一直是当前日期的bug
-- [add] 增加`util.getTaskTreeList()`工具函数
-- [add] 增加`layerGroups`、`bmapTypes`、`colors`、`defaultLayers`、`layerFolders`、`layerIcons`、`mapViewModes`、`taskParams`、`tools`常量
-
-## v1.0.4
-
-- [add] 常量`layerGroups`增加覆盖物分组
-- [add] 常量`layerIcons`增加overlay/geojson/raster/object类型图标
-
-## v1.0.5
-
-- [fix] 地图底图的服务地址修改为https协议
-- [fix] 工具函数`diffLayers`增加覆盖物图层更新的比较
-
-## v1.0.6
-
-- [improve] `util.getPhotoInfo`函数返回值增加图像的width和height
-
-## v1.0.7
-
-- [fix] 修复获取exif中可能存在宽高错误的问题
-- [improve] 获取照片属性时没有GPS也会返回其他的属性信息
-
-## v1.0.8
-
-- [improve] 支持tiff等其他格式图片获取宽高
-
-## v1.0.9
-
-- [fix] 修复华为相机的照片解析失败的问题
-
-## v1.0.10
-
-- [add] 增加`util.hasNaN()`和`util.getRotationMatrix()`接口
-- [add] 增加常量`crsTypes` `measurementFields`
-- [improve] 更新常量`defaultLayers`和`layerFolders`
-- [delete] 删除`getPhotoTags`接口
-
-## v1.0.11
-
-- [add] 增加`util.getWKTString(epsg_code)`接口
-- [add] 增加常量`crsList`
-
-## v1.0.12
-
-- [improve] 点标注的显示字段增加经度（lng）和纬度（lat）
-
-## v1.0.13
-
-- [improve] diffLayers检查所有图层的metadata，有变化则提交更新
-
-## v1.0.14
-
-- [improve] addIcons2Map支持sdf符号