2d-bicubic-interpolate 中文文档教程

Question

2d-bicubic-interpolate

Ver. 1.0.7

此版本包括 Akshat Khare 的贡献。 根据 Akshat 拉取请求：

Previously the code failed for matrices with repeated value of z for
different record, which is undesired, so changed the code to accomodate
that issue.

Description

这个包是 cubic-spline 的简单实现，由 morganherlocker 用于双向插值（二维数组）。
此包的假定目的是插入两个变量的离散函数（例如，对于曲面图）。

z = f(x,y)

以下包是为另一个项目开发的，该项目利用它进行曲面图插值。

Dependencies

由于两个依赖项，程序包运行。 首先，当然是 cubic-spline by morganherlocker。 运行 2d-bicubic-spline 所需的另一个小包是 split-array，由 Arthur Verschaeve。 用于测试的开发依赖项包括 Mocha & 柴。

Install

安装包：

npm install --save 2d-bicubic-interpolate

Include in your project

import interpolateArray from '2d-bicubic-interpolate';

API

interpolateArray(data, n);

函数有两个参数：数据，包括要插值的数据集，以及描述插值“强度”的参数 n。 函数返回插值数据集。

data

数据集应该代表 离散函数 两个变量。 数据集应该是一个对象数组，其中每个对象都代表每个函数点的坐标。 坐标值应为实数。

const data = [
    {
        x: 0, 
        y: 0, 
        z: 2
    },
    {
        x: 1, 
        y: 0, 
        z: 0.3
    },
    {
        x: 0, 
        y: 1, 
        z: 1.4
    },
    {
        x: 1, 
        y: 1, 
        z: 2.5
    }
]

n parameter - the interpolation factor

插值因子，n参数需要是正整数或0。这个数字描述了多少个新点将被放置在主点之间。 例如，对于 n = 4，在输入数据的每 2 个主要点之间，将计算并插入四个新点。 对于 n = 0，不应用插值，输出与输入相同。

Output

函数 interpolateArray 返回新数据集，其结构与输入相同。 新数据数组的长度描述为：

L1 = L0 + (L0 - 1) * n

其中：
L1 - 输出数组的长度
L0 - 输入数组的长度
n - 插值因子

Examples

Example 1

import interpolateArray from '2d-bicubic-interpolate';
const data = [
    {
        x: 0,
        y: 0,
        z: 0.3
    },
    {
        x: 1,
        y: 0,
        z: 1.2
    },
    {
        x: 0,
        y: 1,
        z: 1.4
    },
    {
        x: 1,
        y: 1,
        z: 2.2
    }
];

console.log(interpolateArray(data, 1));

/*
console: 

(9) [{…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}, {…}]
0:{x: 0, y: 0, z: 0.3}
1:{x: 0, y: 0.5, z: 0.85}
2:{x: 0, y: 1, z: 1.4}
3:{x: 0.5, y: 0, z: 0.75}
4:{x: 0.5, y: 0.5, z: 1.275}
5:{x: 0.5, y: 1, z: 1.8}
6:{x: 1, y: 0, z: 1.2}
7:{x: 1, y: 0.5, z: 1.7}
8:{x: 1, y: 1, z: 2.2}
*/

Example 2

算法的工作原理由 3D 曲面图 (vis.js) 表示，表示一些双变量的离散函数。< br> 插值前数据：

InterpolateArray(data, 0);    

用不同插值因子插值的数据： 使用不同插值因子插值的数据：

InterpolateArray(data, 1);  

InterpolateArray(data, 10);