npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

complex-esm

v2.1.1-esm1

Published

A complex numbers library

Downloads

7,149

Readme

Complex.js - ℂ in JavaScript

NPM Package

Build Status MIT license

Complex.js is a well tested JavaScript library to work with complex number arithmetic in JavaScript. It implements every elementary complex number manipulation function and the API is intentionally similar to Fraction.js. Furthermore, it's the basis of Polynomial.js and Math.js.

Examples

let Complex = require('complex.js');

let c = new Complex("99.3+8i");
c.mul({re: 3, im: 9}).div(4.9).sub(3, 2);

A classical use case for complex numbers is solving quadratic equations ax² + bx + c = 0 for all a, b, c ∈ ℝ:


function quadraticRoot(a, b, c) {
  let sqrt = Complex(b * b - 4 * a * c).sqrt()
  let x1 = Complex(-b).add(sqrt).div(2 * a)
  let x2 = Complex(-b).sub(sqrt).div(2 * a)
  return {x1, x2}
}

// quadraticRoot(1, 4, 5) -> -2 ± i

Parser

Any function (see below) as well as the constructor of the Complex class parses its input like this.

You can pass either Objects, Doubles or Strings.

Objects

new Complex({re: real, im: imaginary});
new Complex({arg: angle, abs: radius});
new Complex({phi: angle, r: radius});
new Complex([real, imaginary]); // Vector/Array syntax

If there are other attributes on the passed object, they're not getting preserved and have to be merged manually.

Doubles

new Complex(55.4);

Strings

new Complex("123.45");
new Complex("15+3i");
new Complex("i");

Two arguments

new Complex(3, 2); // 3+2i

Attributes

Every complex number object exposes its real and imaginary part as attribute re and im:

let c = new Complex(3, 2);

console.log("Real part:", c.re); // 3
console.log("Imaginary part:", c.im); // 2

Functions

Complex sign()

Returns the complex sign, defined as the complex number normalized by it's absolute value

Complex add(n)

Adds another complex number

Complex sub(n)

Subtracts another complex number

Complex mul(n)

Multiplies the number with another complex number

Complex div(n)

Divides the number by another complex number

Complex pow(exp)

Returns the number raised to the complex exponent (Note: Complex.ZERO.pow(0) = Complex.ONE by convention)

Complex sqrt()

Returns the complex square root of the number

Complex exp(n)

Returns e^n with complex exponent n.

Complex log()

Returns the natural logarithm (base E) of the actual complex number

Note: The logarithm to a different base can be calculated with z.log().div(Math.log(base)).

double abs()

Calculates the magnitude of the complex number

double arg()

Calculates the angle of the complex number

Complex inverse()

Calculates the multiplicative inverse of the complex number (1 / z)

Complex conjugate()

Calculates the conjugate of the complex number (multiplies the imaginary part with -1)

Complex neg()

Negates the number (multiplies both the real and imaginary part with -1) in order to get the additive inverse

Complex floor([places=0])

Floors the complex number parts towards zero

Complex ceil([places=0])

Ceils the complex number parts off zero

Complex round([places=0])

Rounds the complex number parts

boolean equals(n)

Checks if both numbers are exactly the same, if both numbers are infinite they are considered not equal.

boolean isNaN()

Checks if the given number is not a number

boolean isFinite()

Checks if the given number is finite

Complex clone()

Returns a new Complex instance with the same real and imaginary properties

Array toVector()

Returns a Vector of the actual complex number with two components

String toString()

Returns a string representation of the actual number. As of v1.9.0 the output is a bit more human readable

new Complex(1, 2).toString(); // 1 + 2i
new Complex(0, 1).toString(); // i
new Complex(9, 0).toString(); // 9
new Complex(1, 1).toString(); // 1 + i

double valueOf()

Returns the real part of the number if imaginary part is zero. Otherwise null

Trigonometric functions

The following trigonometric functions are defined on Complex.js:

| Trig | Arcus | Hyperbolic | Area-Hyperbolic | |------|-------|------------|------------------| | sin() | asin() | sinh() | asinh() | | cos() | acos() | cosh() | acosh() | | tan() | atan() | tanh() | atanh() | | cot() | acot() | coth() | acoth() | | sec() | asec() | sech() | asech() | | csc() | acsc() | csch() | acsch() |

Geometric Equivalence

Complex numbers can also be seen as a vector in the 2D space. Here is a simple overview of basic operations and how to implement them with complex.js:

New vector

let v1 = new Complex(1, 0);
let v2 = new Complex(1, 1);

Scale vector

scale(v1, factor):= v1.mul(factor)

Vector norm

norm(v):= v.abs()

Translate vector

translate(v1, v2):= v1.add(v2)

Rotate vector around center

rotate(v, angle):= v.mul({abs: 1, arg: angle})

Rotate vector around a point

rotate(v, p, angle):= v.sub(p).mul({abs: 1, arg: angle}).add(p)

Distance to another vector

distance(v1, v2):= v1.sub(v2).abs()

Constants

Complex.ZERO

A complex zero value (south pole on the Riemann Sphere)

Complex.ONE

A complex one instance

Complex.INFINITY

A complex infinity value (north pole on the Riemann Sphere)

Complex.NAN

A complex NaN value (not on the Riemann Sphere)

Complex.I

An imaginary number i instance

Complex.PI

A complex PI instance

Complex.E

A complex euler number instance

Complex.EPSILON

A small epsilon value used for equals() comparison in order to circumvent double imprecision.

Installation

Installing complex.js is as easy as cloning this repo or use one of the following commands:

bower install complex.js

or

npm install complex.js

Using Complex.js with the browser

<script src="complex.js"></script>
<script>
    console.log(Complex("4+3i"));
</script>

Using Complex.js with require.js

<script src="require.js"></script>
<script>
requirejs(['complex.js'],
function(Complex) {
    console.log(Complex("4+3i"));
});
</script>

Coding Style

As every library I publish, complex.js is also built to be as small as possible after compressing it with Google Closure Compiler in advanced mode. Thus the coding style orientates a little on maxing-out the compression rate. Please make sure you keep this style if you plan to extend the library.

Testing

If you plan to enhance the library, make sure you add test cases and all the previous tests are passing. You can test the library with

npm test

Copyright and licensing

Copyright (c) 2023, Robert Eisele Dual licensed under the MIT or GPL Version 2 licenses.