Package org.djunits.quantity

Class Position

java.lang.Object

java.lang.Number

org.djunits.quantity.def.AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

org.djunits.quantity.Position

All Implemented Interfaces:

Serializable, Comparable<Position>, Value<Length.Unit,Position>

public class Position
extends AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

Position is the absolute equivalent of Length, and can, e.g., represent an absolute offset relative to a defined origin.

Copyright (c) 2025-2026 Delft University of Technology, Jaffalaan 5, 2628 BX Delft, the Netherlands. All rights reserved. See for project information https://djunits.org. The DJUNITS project is distributed under a three-clause BSD-style license.

Author:

Alexander Verbraeck

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Position.Reference	The reference class to define a reference point for the position.

Constructor Summary

Constructors

Constructor	Description
Position(double value, String abbreviation, Position.Reference reference)	Instantiate a Position quantity with a unit, expressed as a String, and a reference point.
Position(double value, Length.Unit unit, Position.Reference reference)	Instantiate a Position quantity with a unit and a reference point.
Position(Length length, Position.Reference reference)	Instantiate a Position instance based on an length and a reference point.

Method Summary

Modifier and Type	Method	Description
Position	add(Length other)	Add a relative quantity to this absolute quantity, resulting in a new absolute quantity containing the sum.
Position	instantiate(Length length, Position.Reference reference)	Instantiate an absolute quantity with a quantity and a reference.
static Position	of(double value, String unitString, Position.Reference reference)	Returns a Position based on a value and the textual representation of the unit, which can be localized.
static Position	ofSi(double si, Position.Reference reference)	Return a Position instance based on an SI value and a reference point.
SIUnit	siUnit()	Return the SI unit of this quantity.
Position	subtract(Length other)	Subtract a relative quantity from this absolute quantity, resulting in a new absolute quantity containing the difference.
Length	subtract(Position other)	Subtract two absolute quantities from each other, resulting in the corresponding relative quantity.
static Position	valueOf(String text, Position.Reference reference)	Returns a Position representation of a textual representation of a value with a unit.

Methods inherited from class org.djunits.quantity.def.AbsoluteQuantity

compareTo, doubleValue, eq, eq0, equals, floatValue, format, format, ge, ge0, getDisplayUnit, getInUnit, getInUnit, getName, getQuantity, getReference, gt, gt0, hashCode, interpolate, intValue, isRelative, le, le0, longValue, lt, lt0, max, mean, min, ne, ne0, of, relativeTo, setDisplayUnit, si, sum, toDisplayString, toDisplayString, toString, toString, toString, toString, toStringSIPrefixed, toStringSIPrefixed, toTextualString, toTextualString, valueOf

Methods inherited from class java.lang.Number

byteValue, shortValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.djunits.value.Value

isAbsolute, setDisplayUnit

Constructor Details

Position

public Position(double value,
 Length.Unit unit,
 Position.Reference reference)

Instantiate a Position quantity with a unit and a reference point.

Parameters:

value - the length value, expressed in a length unit

unit - the length unit in which the value is expressed, relative to the reference point

reference - the reference point of this position

Position

public Position(double value,
 String abbreviation,
 Position.Reference reference)

Instantiate a Position quantity with a unit, expressed as a String, and a reference point.

Parameters:

value - the length value, expressed in the unit, relative to the reference point

abbreviation - the String abbreviation of the unit in which the value is expressed

reference - the reference point of this position

Position

public Position(Length length,
 Position.Reference reference)

Instantiate a Position instance based on an length and a reference point.

Parameters:

length - the length, relative to the reference point

reference - the reference point of this position

Method Details

ofSi

public static Position ofSi(double si,
 Position.Reference reference)

Return a Position instance based on an SI value and a reference point.

Parameters:

si - the length si value, relative to the reference point

reference - the reference point of this position

Returns:

the Position instance based on an SI value

instantiate

public Position instantiate(Length length,
 Position.Reference reference)

Description copied from class: AbsoluteQuantity

Instantiate an absolute quantity with a quantity and a reference.

Specified by:

instantiate in class AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

Parameters:

length - the relative quantity that indicates the 'distance' to the reference point

reference - the reference point

Returns:

the absolute quantity with a quantity and a reference

siUnit

public SIUnit siUnit()

Description copied from class: AbsoluteQuantity

Return the SI unit of this quantity.

Overrides:

siUnit in class AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

Returns:

the SI unit of this quantity

valueOf

public static Position valueOf(String text,
 Position.Reference reference)

Returns a Position representation of a textual representation of a value with a unit. The String representation that can be parsed is the double value in the unit, followed by a localized or English abbreviation of the unit. Spaces are allowed, but not required, between the value and the unit.

Parameters:

text - the textual representation to parse into a Position

reference - the reference point of this position

Returns:

the Scalar representation of the value in its unit

Throws:

IllegalArgumentException - when the text cannot be parsed

NullPointerException - when the text argument is null

of

public static Position of(double value,
 String unitString,
 Position.Reference reference)

Returns a Position based on a value and the textual representation of the unit, which can be localized.

Parameters:

value - the value to use

unitString - the textual representation of the unit

reference - the reference point of this position

Returns:

the Scalar representation of the value in its unit

Throws:

IllegalArgumentException - when the unit cannot be parsed or is incorrect

NullPointerException - when the unitString argument is null

subtract

public Length subtract(Position other)

Description copied from class: AbsoluteQuantity

Subtract two absolute quantities from each other, resulting in the corresponding relative quantity. The unit of the resulting quantity will be the unit of 'this' absolute quantity. Quantity 'other' will be transformed to the reference point of this absolute quantity. If the reference points of this and other are different, and no transformations between the reference points exist, an exception will be thrown.

Specified by:

subtract in class AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

Parameters:

other - the absolute quantity to subtract

Returns:

the relative quantity as a result of the subtraction

add

public Position add(Length other)

Description copied from class: AbsoluteQuantity

Add a relative quantity to this absolute quantity, resulting in a new absolute quantity containing the sum. The new quantity will have the same reference point and unit as this absolute quantity.

Specified by:

add in class AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

Parameters:

other - the relative quantity to add

Returns:

the absolute quantity as a result of the addition

subtract

public Position subtract(Length other)

Description copied from class: AbsoluteQuantity

Subtract a relative quantity from this absolute quantity, resulting in a new absolute quantity containing the difference. The new quantity will have the same reference point and unit as this absolute quantity.

Specified by:

subtract in class AbsoluteQuantity<Position,Length,Length.Unit,Position.Reference>

Parameters:

other - the relative quantity to subtract

Returns:

the absolute quantity as a result of the subtraction