【SDK】【文档】【修正客户端可视化的文档说明】

Author: 潘卓然ParnDeedlit

src/mapboxgl/overlay/EchartsLayer.js

@@ -10,7 +10,7 @@ import {
 /**
  * mapboxgl的echars 4.0的实现
  * @author 基础平台/创新中心 潘卓然 ParnDeedlit
- * @class mapboxgl.zondy.EchartsLayer
+ * @class module:客户端可视化.EchartsLayer
  * @classdesc 基于mapboxgl的Layer对象进行的拓展
  * @param map - {Object} 传入的mapboxgl的地图对象
  * @param options - {Object} echarts.options 使用 option 来描述其对图表的各种需求，包括：有什么数据、要画什么图表、图表长什么样子、含有什么组件、组件能操作什么事情等等。简而言之，option 表述了：数据、数据如何映射成图形、交互行为。

src/mapboxgl/overlay/MapvLayer.js

@@ -5,7 +5,7 @@ import { MapvBaseLayer } from "./mapv/MapvBaseLayer";
 /**
  * @origin author kyle / http://nikai.us/
  * @author 基础平台/创新中心 潘卓然 ParnDeedlit
- * @class mapboxgl.zondy.MapvLayer
+ * @class module:客户端可视化.MapvLayer
  * @classdesc 基于mapboxgl的Layer对象进行的拓展
  * @param map - {Object} 传入的mapboxgl的地图对象
  * @param dataset - {MapvDataSet} 传入的mapv的属性。 <br>

src/mapboxgl/overlay/index.js

@@ -1,3 +1,6 @@
+/**
+ * @module 客户端可视化
+ */
 import { EchartsLayer } from './EchartsLayer';
 import { MapvLayer } from './MapvLayer';
 

src/openlayers/overlay/MapvLayer.js

@@ -8,11 +8,34 @@ import {
 /**
  * @origin author kyle / http://nikai.us/
  * @author 基础平台/创新中心 潘卓然 ParnDeedlit
- * @class openlayers.zondy.MapvLayer
+ * @class module:客户端可视化.MapvLayer
  * @classdesc 基于mapboxgl的Layer对象进行的拓展
  * @param map - {Object} 传入的mapboxgl的地图对象
  * @param dataset - {MapvDataSet} 传入的mapv的属性。 <br>
  * @param mapvoption - {MapvOption} 可选参数。<br>
+ * @see https://github.com/huiyan-fe/mapv/blob/master/API.md
+ * @example
+ * var options = {
+      size: 13,
+      gradient: {
+        0.25: "rgb(0,0,255)",
+        0.55: "rgb(0,255,0)",
+        0.85: "yellow",
+        1.0: "rgb(255,0,0)"
+      },
+      max: 60,
+      animation: {
+        type: 'time',
+        stepsRange: {
+          start: 0,
+          end: 100
+        },
+        trails: 10,
+        duration: 4,
+      },
+      draw: 'heatmap'
+    }
+    var mapvLayer = new L.zondy.MapvLayer(map, dataSet, options).addTo(map);
  */
 export class MapvLayer /* extends Layer */ {
 

src/openlayers/overlay/index.js

@@ -1,3 +1,6 @@
+/**
+ * @module 客户端可视化
+ */
 /* import {
   EchartsLayer
 } from './EchartsLayer' */

src/service/common/Interpolat.js

@@ -0,0 +1,48 @@
+/**
+ * @author 基础平台/潘卓然
+ * @param {*} points 已有数据坐标集合
+ * @example 
+ * var trues = [
+        [2011, 12131],  // 当前年份的产值
+        [2012, 13345],
+        [2013, 14532],
+        [2014, 15472],
+        [2015, 16945],
+    ];
+
+    f = interpolatingPolynomial(trues);
+
+    // 预测未来的
+    let futures2016 = f(2016);  // 预测未来的产值
+    let futures2017 = f(2017);
+    let futures2018 = f(2018);
+    let futures2019 = f(2019);
+
+    console.log(2016, futures2016);
+    console.log(2017, futures2017);
+    console.log(2018, futures2018);
+    console.log(2019, futures2019);
+
+ * @returns 预测的下一个未来时间点/坐标系X下的的Y值的函数
+ * @see 请注意，返回的是个函数需要再主动传递一次X来进行求值
+ */
+export function interpolateLagrange(points) {
+    var n = points.length - 1, p;
+
+    p = function (i, j, x) {
+        if (i === j) {
+            return points[i][1];
+        }
+
+        return ((points[j][0] - x) * p(i, j - 1, x) +
+                (x - points[i][0]) * p(i + 1, j, x)) /
+            (points[j][0] - points[i][0]);
+    };
+
+    return function (x) {
+        if (points.length === 0) {
+            return 0;
+        }
+        return p(0, n, x);
+    };
+};