@antv/g-math

What is @antv/g-math?

@antv/g-math is a mathematical utility library designed to support geometric calculations, particularly for graphics and visualization purposes. It provides a range of functions for handling vector, matrix, and geometry operations, making it useful for developers working on graphical applications.

What are @antv/g-math's main functionalities?

Vector Operations

This feature allows you to perform various vector operations such as addition, subtraction, scaling, and normalization. The code sample demonstrates how to add two 2D vectors.

const { vec2 } = require('@antv/g-math');

const v1 = [1, 2];
const v2 = [3, 4];
const result = vec2.add([], v1, v2);
console.log(result); // Output: [4, 6]

Matrix Operations

This feature provides functions for matrix operations such as multiplication, inversion, and transposition. The code sample shows how to multiply two 3x3 matrices.

const { mat3 } = require('@antv/g-math');

const m1 = [1, 0, 0, 0, 1, 0, 0, 0, 1];
const m2 = [2, 0, 0, 0, 2, 0, 0, 0, 2];
const result = mat3.multiply([], m1, m2);
console.log(result); // Output: [2, 0, 0, 0, 2, 0, 0, 0, 2]

Geometry Calculations

This feature includes functions for various geometric calculations like computing the length of a line, finding intersections, and calculating angles. The code sample demonstrates how to calculate the length of a line segment between two points.

const { line } = require('@antv/g-math');

const point1 = [0, 0];
const point2 = [3, 4];
const length = line.length(point1, point2);
console.log(length); // Output: 5

Other packages similar to @antv/g-math

gl-matrix

gl-matrix is a high-performance matrix and vector library for WebGL. It offers similar functionalities for vector and matrix operations but is optimized for WebGL applications. Compared to @antv/g-math, gl-matrix is more focused on performance and is widely used in 3D graphics.

mathjs

mathjs is a comprehensive math library for JavaScript and Node.js. It provides a wide range of mathematical functions, including support for complex numbers, matrices, and units. While it offers more general mathematical capabilities compared to @antv/g-math, it may not be as specialized for geometric calculations.

d3-geo

d3-geo is a module of D3.js that provides geographic projections and related utilities. It is particularly useful for creating maps and handling geographic data. While it overlaps with @antv/g-math in terms of geometric calculations, d3-geo is more specialized for geographic applications.

README

g-math

为 G 提供几何图形运算的库

安装下载

tnpm i --save @antv/g-math

// 所有的 api 是都这么引入，名字不同而已
import { line } from '@antv/g-math';

const len = line.length(x1, x2, x2, y2);

API 文档

目前使用到的、且推荐使用的 API 文档，不在文档内的不建议使用。