Number.Complex

Complex numbers.

Cartesian form

data T a

Complex numbers are an algebraic type.

Instances

Functor T

C T

C a b => C a (T b)

The '(*>)' method can't replace scale because it requires the Algebra.Module constraint

C a b => C a (T b)

(C a, Sqr a b) => C a (T b)

Sqr a b => Sqr a (T b)

(Ord a, C a v) => C a (T v)

(C a, C a v) => C a (T v)

(Show v, C v, C v, C a v) => C a (T v)

Eq a => Eq (T a)

(Floating a, Eq a) => Fractional (T a)

(Floating a, Eq a) => Num (T a)

Read a => Read (T a)

Show a => Show (T a)

Arbitrary a => Arbitrary (T a)

Storable a => Storable (T a)

C a => C (T a)

C a => C (T a)

C a => C (T a)

C a => C (T a)

C a => C (T a)

(Ord a, C a) => C (T a)

(Ord a, C a, C a) => C (T a)

(C a, C a, C a) => C (T a)

C a => C (T a)

(C a, C a, Power a) => C (T a)

(C a, C a, C a, Power a) => C (T a)

imaginaryUnit :: C a => T a

fromReal :: C a => a -> T a

(+:) :: a -> a -> T a

Construct a complex number from real and imaginary part.

(-:) :: C a => a -> a -> T a

Construct a complex number with negated imaginary part.

scale :: C a => a -> T a -> T a

Scale a complex number by a real number.

exp :: C a => T a -> T a

Exponential of a complex number with minimal type class constraints.

quarterLeft :: C a => T a -> T a

Turn the point one quarter to the right.

quarterRight :: C a => T a -> T a

Turn the point one quarter to the right.

Polar form

fromPolar :: C a => a -> a -> T a

Form a complex number from polar components of magnitude and phase.

cis :: C a => a -> T a

cis t is a complex value with magnitude 1 and phase t (modulo 2*pi).

signum :: (C a, C a) => T a -> T a

Scale a complex number to magnitude 1.

For a complex number z, abs z is a number with the magnitude of z, but oriented in the positive real direction, whereas signum z has the phase of z, but unit magnitude.

signumNorm :: (C a, C a a, C a) => T a -> T a

toPolar :: (C a, C a) => T a -> (a, a)

The function toPolar takes a complex number and returns a (magnitude, phase) pair in canonical form: the magnitude is nonnegative, and the phase in the range (-pi, pi]; if the magnitude is zero, then so is the phase.

magnitude :: C a => T a -> a

magnitudeSqr :: C a => T a -> a

phase :: (C a, C a) => T a -> a

The phase of a complex number, in the range (-pi, pi]. If the magnitude is zero, then so is the phase.

Conjugate

conjugate :: C a => T a -> T a

The conjugate of a complex number.

Properties

propPolar :: (C a, C a) => T a -> Bool

Auxiliary classes

class C a => Power a where

We like to build the Complex Algebraic instance on top of the Algebraic instance of the scalar type. This poses no problem to sqrt. However, root requires computing the complex argument which is a transcendent operation. In order to keep the type class dependencies clean for more sophisticated algebraic number types, we introduce a type class which actually performs the radix operation.

Methods

power :: Rational -> T a -> T a

Instances

Power Double

Power Float

Power T

defltPow :: (C a, C a) => Rational -> T a -> T a