Class PrimitiveScalar

java.lang.Object

org.ojalgo.scalar.PrimitiveScalar

All Implemented Interfaces:

Comparable<Double>, Field<Scalar<Double>>, Group, Group.Additive<Scalar<Double>>, Group.Multiplicative<Scalar<Double>>, NormedVectorSpace<Scalar<Double>, Double>, Operation, Operation.Addition<Scalar<Double>>, Operation.Division<Scalar<Double>>, Operation.Multiplication<Scalar<Double>>, Operation.Subtraction<Scalar<Double>>, Ring<Scalar<Double>>, ScalarOperation, ScalarOperation.Addition<Scalar<Double>, Double>, ScalarOperation.Division<Scalar<Double>, Double>, ScalarOperation.Multiplication<Scalar<Double>, Double>, ScalarOperation.Subtraction<Scalar<Double>, Double>, VectorSpace<Scalar<Double>, Double>, Scalar<Double>, AccessScalar<Double>, Tensor<Double, Scalar<Double>>, NumberContext.Enforceable<PrimitiveScalar>, NumberDefinition

public final class PrimitiveScalar
extends Object
implements Scalar<Double>, NumberContext.Enforceable<PrimitiveScalar>

Nested Class Summary

Nested classes/interfaces inherited from interface Group

Group.Additive<T>, Group.Multiplicative<T>

Nested classes/interfaces inherited from interface Operation

Operation.Addition<T>, Operation.Division<T>, Operation.Multiplication<T>, Operation.Subtraction<T>

Nested classes/interfaces inherited from interface Scalar

Scalar.Factory<N>

Nested classes/interfaces inherited from interface ScalarOperation

ScalarOperation.Addition<T,N>, ScalarOperation.Division<T,N>, ScalarOperation.Multiplication<T,N>, ScalarOperation.Subtraction<T,N>

Field Summary

Fields

Modifier and Type	Field	Description
(package private) static final NumberContext	CONTEXT
static final Scalar.Factory<Double>	FACTORY
private final double	myValue
static final PrimitiveScalar	NaN
static final PrimitiveScalar	NEG
static final PrimitiveScalar	NEGATIVE_INFINITY
static final PrimitiveScalar	ONE
static final PrimitiveScalar	POSITIVE_INFINITY
static final PrimitiveScalar	TWO
static final PrimitiveScalar	ZERO

Constructor Summary

Constructors

Modifier	Constructor	Description
	PrimitiveScalar()
private	PrimitiveScalar(double value)

Method Summary

Modifier and Type	Method	Description
PrimitiveScalar	add(double arg)
PrimitiveScalar	add(float scalarAddend)
PrimitiveScalar	add(Double arg)
int	compareTo(Double reference)
PrimitiveScalar	conjugate()	This method will (most likely) be moved to some other interface in the future! Just have to figure out where it fits...
PrimitiveScalar	divide(double arg)
PrimitiveScalar	divide(float scalarDivisor)
PrimitiveScalar	divide(Double arg)
double	doubleValue()
PrimitiveScalar	enforce(NumberContext context)
boolean	equals(Object obj)
float	floatValue()
Double	get()
int	hashCode()
int	intValue()
PrimitiveScalar	invert()	The multiplicative inverse.
boolean	isAbsolute()
static boolean	isAbsolute(double value)
static boolean	isInfinite(double value)
static boolean	isNaN(double value)
boolean	isSmall(double comparedTo)
static boolean	isSmall(double comparedTo, double value)
boolean	isZero()	Tests if this scalar value is exactly zero.
long	longValue()
PrimitiveScalar	multiply(double arg)
PrimitiveScalar	multiply(float scalarMultiplicand)
PrimitiveScalar	multiply(Double arg)
PrimitiveScalar	negate()	The additive inverse of this.
double	norm()	this == this.signum().multiply(this.norm())
static PrimitiveScalar	of(double value)
PrimitiveScalar	power(int power)	Multiply by itself power times.
PrimitiveScalar	signum()	this == this.signum().multiply(this.norm())
PrimitiveScalar	subtract(double arg)
PrimitiveScalar	subtract(float scalarSubtrahend)
PrimitiveScalar	subtract(Double arg)
BigDecimal	toBigDecimal()
String	toString()
String	toString(NumberContext context)
static PrimitiveScalar	valueOf(double value)
static PrimitiveScalar	valueOf(Comparable<?> number)

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface NumberDefinition

booleanValue, byteValue, shortValue

Methods inherited from interface Scalar

add, dimensions, divide, multiply, rank, subtract, toPlainString

Methods inherited from interface Tensor

components, isSameShape

Field Details

FACTORY

public static final Scalar.Factory<Double> FACTORY

NaN

public static final PrimitiveScalar NaN

NEG

public static final PrimitiveScalar NEG

NEGATIVE_INFINITY

public static final PrimitiveScalar NEGATIVE_INFINITY

ONE

public static final PrimitiveScalar ONE

POSITIVE_INFINITY

public static final PrimitiveScalar POSITIVE_INFINITY

TWO

public static final PrimitiveScalar TWO

ZERO

public static final PrimitiveScalar ZERO

CONTEXT

static final NumberContext CONTEXT

myValue

private final double myValue

Constructor Details

PrimitiveScalar

public PrimitiveScalar()

PrimitiveScalar

private PrimitiveScalar(double value)

Method Details

isAbsolute

public static boolean isAbsolute(double value)

isInfinite

public static boolean isInfinite(double value)

isNaN

public static boolean isNaN(double value)

isSmall

public static boolean isSmall(double comparedTo,
 double value)

of

public static PrimitiveScalar of(double value)

valueOf

public static PrimitiveScalar valueOf(Comparable<?> number)

valueOf

public static PrimitiveScalar valueOf(double value)

add

public PrimitiveScalar add(double arg)

Specified by:

add in interface ScalarOperation.Addition<Scalar<Double>, Double>

Returns:

this + scalarAddend.

add

public PrimitiveScalar add(Double arg)

Specified by:

add in interface ScalarOperation.Addition<Scalar<Double>, Double>

Returns:

this + scalarAddend.

add

public PrimitiveScalar add(float scalarAddend)

Specified by:

add in interface ScalarOperation.Addition<Scalar<Double>, Double>

Returns:

this + scalarAddend.

compareTo

public int compareTo(Double reference)

Specified by:

compareTo in interface Comparable<Double>

conjugate

public PrimitiveScalar conjugate()

Description copied from interface: VectorSpace

This method will (most likely) be moved to some other interface in the future! Just have to figure out where it fits...

The conjugate transpose of a matrix and/or the conjugate of a scalar/field like ComplexNumber or Quaternion.

The conjugate transpose of a real matrix is simply its transpose.

Specified by:

conjugate in interface VectorSpace<Scalar<Double>, Double>

divide

public PrimitiveScalar divide(double arg)

Specified by:

divide in interface ScalarOperation.Division<Scalar<Double>, Double>

Returns:

this / scalarDivisor.

divide

public PrimitiveScalar divide(Double arg)

Specified by:

divide in interface ScalarOperation.Division<Scalar<Double>, Double>

Returns:

this / scalarDivisor.

divide

public PrimitiveScalar divide(float scalarDivisor)

Specified by:

divide in interface ScalarOperation.Division<Scalar<Double>, Double>

Returns:

this / scalarDivisor.

doubleValue

public double doubleValue()

Specified by:

doubleValue in interface NumberDefinition

enforce

public PrimitiveScalar enforce(NumberContext context)

Specified by:

enforce in interface NumberContext.Enforceable<PrimitiveScalar>

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

floatValue

public float floatValue()

Specified by:

floatValue in interface NumberDefinition

get

public Double get()

Specified by:

get in interface AccessScalar<Double>

hashCode

public int hashCode()

Overrides:

hashCode in class Object

intValue

public int intValue()

Specified by:

intValue in interface NumberDefinition

invert

public PrimitiveScalar invert()

Description copied from interface: Group.Multiplicative

The multiplicative inverse.

Specified by:

invert in interface Group.Multiplicative<Scalar<Double>>

Returns:

IDENTITY / this.

isAbsolute

public boolean isAbsolute()

Specified by:

isAbsolute in interface Scalar<Double>

Returns:

true if this is equal to its own norm, modulus or absolute value (non-negative real part and no imaginary part); otherwise false.

See Also:

• Scalar.isAbsolute()

isSmall

public boolean isSmall(double comparedTo)

Specified by:

isSmall in interface NormedVectorSpace<Scalar<Double>, Double>

Parameters:

comparedTo - What to compare with

Returns:

true if this is small compared to the magnitude of the input reference value.

isZero

public boolean isZero()

Description copied from interface: Scalar

Tests if this scalar value is exactly zero.

Each implementation should test for zero as exactly as possible based on what's achievable with that specific scalar type. The purpose is NOT to have similar behavior between different implementations, but rather to leverage the full precision and capabilities of each type.

For example:

• Primitive types (like double) should use exact equality comparison
• High-precision types (like Quadruple) should check both base and remainder components
• Arbitrary-precision types (like BigDecimal) should use their built-in zero detection
• Complex types should check both real and imaginary parts

This method should NOT use tolerance-based comparisons or approximate zero detection, as those are better handled by context-aware methods like NormedVectorSpace.isSmall(double).

Specified by:

isZero in interface Scalar<Double>

Returns:

true if this scalar represents exactly zero, false otherwise

See Also:

• NormedVectorSpace.isSmall(double)

longValue

public long longValue()

Specified by:

longValue in interface NumberDefinition

multiply

public PrimitiveScalar multiply(double arg)

Specified by:

multiply in interface ScalarOperation.Multiplication<Scalar<Double>, Double>

Returns:

this * scalarMultiplicand.

multiply

public PrimitiveScalar multiply(Double arg)

Specified by:

multiply in interface ScalarOperation.Multiplication<Scalar<Double>, Double>

Returns:

this * multiplicand.

multiply

public PrimitiveScalar multiply(float scalarMultiplicand)

Specified by:

multiply in interface ScalarOperation.Multiplication<Scalar<Double>, Double>

Returns:

this * scalarMultiplicand.

negate

public PrimitiveScalar negate()

Description copied from interface: Group.Additive

The additive inverse of this.

Specified by:

negate in interface Group.Additive<Scalar<Double>>

Returns:

-this.

norm

public double norm()

Description copied from interface: NormedVectorSpace

this == this.signum().multiply(this.norm())

Specified by:

norm in interface NormedVectorSpace<Scalar<Double>, Double>

Returns:

The norm

power

public PrimitiveScalar power(int power)

Description copied from interface: Operation.Multiplication

Multiply by itself power times.

Specified by:

power in interface Operation.Multiplication<Scalar<Double>>

signum

public PrimitiveScalar signum()

Description copied from interface: NormedVectorSpace

this == this.signum().multiply(this.norm())

Specified by:

signum in interface NormedVectorSpace<Scalar<Double>, Double>

Returns:

A unit "vector"

subtract

public PrimitiveScalar subtract(double arg)

Specified by:

subtract in interface ScalarOperation.Subtraction<Scalar<Double>, Double>

Returns:

this - scalarSubtrahend.

subtract

public PrimitiveScalar subtract(Double arg)

Specified by:

subtract in interface ScalarOperation.Subtraction<Scalar<Double>, Double>

Returns:

this - scalarSubtrahend.

subtract

public PrimitiveScalar subtract(float scalarSubtrahend)

Specified by:

subtract in interface ScalarOperation.Subtraction<Scalar<Double>, Double>

Returns:

this - scalarSubtrahend.

toBigDecimal

public BigDecimal toBigDecimal()

Specified by:

toBigDecimal in interface Scalar<Double>

toString

public String toString()

Overrides:

toString in class Object

toString

public String toString(NumberContext context)

Specified by:

toString in interface Scalar<Double>