1 package org.djunits.value.vdouble.scalar;
2
3 import java.util.Locale;
4
5 import org.djunits.unit.LengthUnit;
6 import org.djunits.unit.PositionUnit;
7 import org.djunits.value.vdouble.scalar.base.AbstractDoubleScalarAbs;
8 import org.djutils.base.NumberParser;
9 import org.djutils.exceptions.Throw;
10
11 import jakarta.annotation.Generated;
12
13
14
15
16
17
18
19
20
21
22
23 @Generated(value = "org.djunits.generator.GenerateDJUNIT", date = "2023-04-30T13:59:27.633664900Z")
24 public class Position extends AbstractDoubleScalarAbs<PositionUnit, Position, LengthUnit, Length>
25 {
26
27 private static final long serialVersionUID = 20150901L;
28
29
30 public static final Position ZERO = new Position(0.0, PositionUnit.DEFAULT);
31
32
33
34
35
36
37 public Position(final double value, final PositionUnit unit)
38 {
39 super(value, unit);
40 }
41
42
43
44
45
46 public Position(final Position value)
47 {
48 super(value);
49 }
50
51
52 @Override
53 public final Position instantiateAbs(final double value, final PositionUnit unit)
54 {
55 return new Position(value, unit);
56 }
57
58
59 @Override
60 public final Length instantiateRel(final double value, final LengthUnit unit)
61 {
62 return new Length(value, unit);
63 }
64
65
66
67
68
69
70 public static final Position instantiateSI(final double value)
71 {
72 return new Position(value, PositionUnit.DEFAULT);
73 }
74
75
76
77
78
79
80
81
82 public static Position interpolate(final Position zero, final Position one, final double ratio)
83 {
84 return new Position(zero.getInUnit() * (1 - ratio) + one.getInUnit(zero.getDisplayUnit()) * ratio,
85 zero.getDisplayUnit());
86 }
87
88
89
90
91
92
93
94 public static Position max(final Position a1, final Position a2)
95 {
96 return a1.gt(a2) ? a1 : a2;
97 }
98
99
100
101
102
103
104
105
106 public static Position max(final Position a1, final Position a2, final Position... an)
107 {
108 Position maxa = a1.gt(a2) ? a1 : a2;
109 for (Position a : an)
110 {
111 if (a.gt(maxa))
112 {
113 maxa = a;
114 }
115 }
116 return maxa;
117 }
118
119
120
121
122
123
124
125 public static Position min(final Position a1, final Position a2)
126 {
127 return a1.lt(a2) ? a1 : a2;
128 }
129
130
131
132
133
134
135
136
137 public static Position min(final Position a1, final Position a2, final Position... an)
138 {
139 Position mina = a1.lt(a2) ? a1 : a2;
140 for (Position a : an)
141 {
142 if (a.lt(mina))
143 {
144 mina = a;
145 }
146 }
147 return mina;
148 }
149
150
151
152
153
154
155
156
157
158
159 public static Position valueOf(final String text)
160 {
161 Throw.whenNull(text, "Error parsing Position: text to parse is null");
162 Throw.when(text.length() == 0, IllegalArgumentException.class, "Error parsing Position: empty text to parse");
163 try
164 {
165 NumberParser numberParser = new NumberParser().lenient().trailing();
166 double d = numberParser.parseDouble(text);
167 String unitString = text.substring(numberParser.getTrailingPosition()).trim();
168 PositionUnit unit = PositionUnit.BASE.getUnitByAbbreviation(unitString);
169 if (unit == null)
170 throw new IllegalArgumentException("Unit " + unitString + " not found");
171 return new Position(d, unit);
172 }
173 catch (Exception exception)
174 {
175 throw new IllegalArgumentException(
176 "Error parsing Position from " + text + " using Locale " + Locale.getDefault(Locale.Category.FORMAT),
177 exception);
178 }
179 }
180
181
182
183
184
185
186
187
188
189 public static Position of(final double value, final String unitString)
190 {
191 Throw.whenNull(unitString, "Error parsing Position: unitString is null");
192 Throw.when(unitString.length() == 0, IllegalArgumentException.class, "Error parsing Position: empty unitString");
193 PositionUnit unit = PositionUnit.BASE.getUnitByAbbreviation(unitString);
194 if (unit != null)
195 {
196 return new Position(value, unit);
197 }
198 throw new IllegalArgumentException("Error parsing Position with unit " + unitString);
199 }
200
201 }