View Javadoc
1   package org.djunits.value.vfloat.scalar;
2   
3   import java.util.Locale;
4   
5   import org.djunits.unit.AngleUnit;
6   import org.djunits.unit.AngularVelocityUnit;
7   import org.djunits.unit.DimensionlessUnit;
8   import org.djunits.unit.DurationUnit;
9   import org.djunits.unit.ElectricalCapacitanceUnit;
10  import org.djunits.unit.ElectricalChargeUnit;
11  import org.djunits.unit.ElectricalInductanceUnit;
12  import org.djunits.unit.EnergyUnit;
13  import org.djunits.unit.LengthUnit;
14  import org.djunits.unit.MagneticFluxUnit;
15  import org.djunits.unit.MassUnit;
16  import org.djunits.unit.SpeedUnit;
17  import org.djunits.unit.TimeUnit;
18  import org.djunits.unit.VolumeUnit;
19  import org.djunits.value.vfloat.scalar.base.AbstractFloatScalarRelWithAbs;
20  import org.djutils.base.NumberParser;
21  import org.djutils.exceptions.Throw;
22  
23  import jakarta.annotation.Generated;
24  
25  /**
26   * Easy access methods for the FloatDuration FloatScalar.
27   * <p>
28   * Copyright (c) 2013-2023 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. <br>
29   * All rights reserved. <br>
30   * BSD-style license. See <a href="https://djunits.org/docs/license.html">DJUNITS License</a>.
31   * </p>
32   * @author <a href="https://www.tudelft.nl/averbraeck">Alexander Verbraeck</a>
33   * @author <a href="https://www.tudelft.nl/staff/p.knoppers/">Peter Knoppers</a>
34   */
35  @Generated(value = "org.djunits.generator.GenerateDJUNIT", date = "2023-04-30T13:59:27.633664900Z")
36  public class FloatDuration extends AbstractFloatScalarRelWithAbs<TimeUnit, FloatTime, DurationUnit, FloatDuration>
37  {
38      /** */
39      private static final long serialVersionUID = 20150901L;
40  
41      /** Constant with value zero. */
42      public static final FloatDuration ZERO = new FloatDuration(0.0f, DurationUnit.SI);
43  
44      /** Constant with value one. */
45      public static final FloatDuration ONE = new FloatDuration(1.0f, DurationUnit.SI);
46  
47      /** Constant with value NaN. */
48      @SuppressWarnings("checkstyle:constantname")
49      public static final FloatDuration NaN = new FloatDuration(Float.NaN, DurationUnit.SI);
50  
51      /** Constant with value POSITIVE_INFINITY. */
52      public static final FloatDuration POSITIVE_INFINITY = new FloatDuration(Float.POSITIVE_INFINITY, DurationUnit.SI);
53  
54      /** Constant with value NEGATIVE_INFINITY. */
55      public static final FloatDuration NEGATIVE_INFINITY = new FloatDuration(Float.NEGATIVE_INFINITY, DurationUnit.SI);
56  
57      /** Constant with value MAX_VALUE. */
58      public static final FloatDuration POS_MAXVALUE = new FloatDuration(Float.MAX_VALUE, DurationUnit.SI);
59  
60      /** Constant with value -MAX_VALUE. */
61      public static final FloatDuration NEG_MAXVALUE = new FloatDuration(-Float.MAX_VALUE, DurationUnit.SI);
62  
63      /**
64       * Construct FloatDuration scalar.
65       * @param value float; the float value
66       * @param unit DurationUnit; unit for the float value
67       */
68      public FloatDuration(final float value, final DurationUnit unit)
69      {
70          super(value, unit);
71      }
72  
73      /**
74       * Construct FloatDuration scalar.
75       * @param value FloatDuration; Scalar from which to construct this instance
76       */
77      public FloatDuration(final FloatDuration value)
78      {
79          super(value);
80      }
81  
82      /**
83       * Construct FloatDuration scalar using a double value.
84       * @param value double; the double value
85       * @param unit DurationUnit; unit for the resulting float value
86       */
87      public FloatDuration(final double value, final DurationUnit unit)
88      {
89          super((float) value, unit);
90      }
91  
92      /** {@inheritDoc} */
93      @Override
94      public final FloatDuration instantiateRel(final float value, final DurationUnit unit)
95      {
96          return new FloatDuration(value, unit);
97      }
98  
99      /**
100      * Construct FloatDuration scalar.
101      * @param value float; the float value in SI units
102      * @return FloatDuration; the new scalar with the SI value
103      */
104     public static final FloatDuration instantiateSI(final float value)
105     {
106         return new FloatDuration(value, DurationUnit.SI);
107     }
108 
109     /** {@inheritDoc} */
110     @Override
111     public final FloatTime instantiateAbs(final float value, final TimeUnit unit)
112     {
113         return new FloatTime(value, unit);
114     }
115 
116     /**
117      * Interpolate between two values.
118      * @param zero FloatDuration; the low value
119      * @param one FloatDuration; the high value
120      * @param ratio double; the ratio between 0 and 1, inclusive
121      * @return FloatDuration; a Scalar at the ratio between
122      */
123     public static FloatDuration interpolate(final FloatDuration zero, final FloatDuration one, final float ratio)
124     {
125         return new FloatDuration(zero.getInUnit() * (1 - ratio) + one.getInUnit(zero.getDisplayUnit()) * ratio,
126                 zero.getDisplayUnit());
127     }
128 
129     /**
130      * Return the maximum value of two relative scalars.
131      * @param r1 FloatDuration; the first scalar
132      * @param r2 FloatDuration; the second scalar
133      * @return FloatDuration; the maximum value of two relative scalars
134      */
135     public static FloatDuration max(final FloatDuration r1, final FloatDuration r2)
136     {
137         return r1.gt(r2) ? r1 : r2;
138     }
139 
140     /**
141      * Return the maximum value of more than two relative scalars.
142      * @param r1 FloatDuration; the first scalar
143      * @param r2 FloatDuration; the second scalar
144      * @param rn FloatDuration...; the other scalars
145      * @return FloatDuration; the maximum value of more than two relative scalars
146      */
147     public static FloatDuration max(final FloatDuration r1, final FloatDuration r2, final FloatDuration... rn)
148     {
149         FloatDuration maxr = r1.gt(r2) ? r1 : r2;
150         for (FloatDuration r : rn)
151         {
152             if (r.gt(maxr))
153             {
154                 maxr = r;
155             }
156         }
157         return maxr;
158     }
159 
160     /**
161      * Return the minimum value of two relative scalars.
162      * @param r1 FloatDuration; the first scalar
163      * @param r2 FloatDuration; the second scalar
164      * @return FloatDuration; the minimum value of two relative scalars
165      */
166     public static FloatDuration min(final FloatDuration r1, final FloatDuration r2)
167     {
168         return r1.lt(r2) ? r1 : r2;
169     }
170 
171     /**
172      * Return the minimum value of more than two relative scalars.
173      * @param r1 FloatDuration; the first scalar
174      * @param r2 FloatDuration; the second scalar
175      * @param rn FloatDuration...; the other scalars
176      * @return FloatDuration; the minimum value of more than two relative scalars
177      */
178     public static FloatDuration min(final FloatDuration r1, final FloatDuration r2, final FloatDuration... rn)
179     {
180         FloatDuration minr = r1.lt(r2) ? r1 : r2;
181         for (FloatDuration r : rn)
182         {
183             if (r.lt(minr))
184             {
185                 minr = r;
186             }
187         }
188         return minr;
189     }
190 
191     /**
192      * Returns a FloatDuration representation of a textual representation of a value with a unit. The String representation that
193      * can be parsed is the double value in the unit, followed by a localized or English abbreviation of the unit. Spaces are
194      * allowed, but not required, between the value and the unit.
195      * @param text String; the textual representation to parse into a FloatDuration
196      * @return FloatDuration; the Scalar representation of the value in its unit
197      * @throws IllegalArgumentException when the text cannot be parsed
198      * @throws NullPointerException when the text argument is null
199      */
200     public static FloatDuration valueOf(final String text)
201     {
202         Throw.whenNull(text, "Error parsing FloatDuration: text to parse is null");
203         Throw.when(text.length() == 0, IllegalArgumentException.class, "Error parsing FloatDuration: empty text to parse");
204         try
205         {
206             NumberParser numberParser = new NumberParser().lenient().trailing();
207             float f = numberParser.parseFloat(text);
208             String unitString = text.substring(numberParser.getTrailingPosition()).trim();
209             DurationUnit unit = DurationUnit.BASE.getUnitByAbbreviation(unitString);
210             if (unit == null)
211                 throw new IllegalArgumentException("Unit " + unitString + " not found");
212             return new FloatDuration(f, unit);
213         }
214         catch (Exception exception)
215         {
216             throw new IllegalArgumentException(
217                     "Error parsing FloatDuration from " + text + " using Locale " + Locale.getDefault(Locale.Category.FORMAT),
218                     exception);
219         }
220     }
221 
222     /**
223      * Returns a FloatDuration based on a value and the textual representation of the unit, which can be localized.
224      * @param value double; the value to use
225      * @param unitString String; the textual representation of the unit
226      * @return FloatDuration; the Scalar representation of the value in its unit
227      * @throws IllegalArgumentException when the unit cannot be parsed or is incorrect
228      * @throws NullPointerException when the unitString argument is null
229      */
230     public static FloatDuration of(final float value, final String unitString)
231     {
232         Throw.whenNull(unitString, "Error parsing FloatDuration: unitString is null");
233         Throw.when(unitString.length() == 0, IllegalArgumentException.class, "Error parsing FloatDuration: empty unitString");
234         DurationUnit unit = DurationUnit.BASE.getUnitByAbbreviation(unitString);
235         if (unit != null)
236         {
237             return new FloatDuration(value, unit);
238         }
239         throw new IllegalArgumentException("Error parsing FloatDuration with unit " + unitString);
240     }
241 
242     /**
243      * Calculate the division of FloatDuration and FloatDuration, which results in a FloatDimensionless scalar.
244      * @param v FloatDuration; scalar
245      * @return FloatDimensionless; scalar as a division of FloatDuration and FloatDuration
246      */
247     public final FloatDimensionless divide(final FloatDuration v)
248     {
249         return new FloatDimensionless(this.si / v.si, DimensionlessUnit.SI);
250     }
251 
252     /**
253      * Calculate the multiplication of FloatDuration and FloatFrequency, which results in a FloatDimensionless scalar.
254      * @param v FloatDuration; scalar
255      * @return FloatDimensionless; scalar as a multiplication of FloatDuration and FloatFrequency
256      */
257     public final FloatDimensionless times(final FloatFrequency v)
258     {
259         return new FloatDimensionless(this.si * v.si, DimensionlessUnit.SI);
260     }
261 
262     /**
263      * Calculate the multiplication of FloatDuration and FloatElectricalCurrent, which results in a FloatElectricalCharge
264      * scalar.
265      * @param v FloatDuration; scalar
266      * @return FloatElectricalCharge; scalar as a multiplication of FloatDuration and FloatElectricalCurrent
267      */
268     public final FloatElectricalCharge times(final FloatElectricalCurrent v)
269     {
270         return new FloatElectricalCharge(this.si * v.si, ElectricalChargeUnit.SI);
271     }
272 
273     /**
274      * Calculate the multiplication of FloatDuration and FloatFlowMass, which results in a FloatMass scalar.
275      * @param v FloatDuration; scalar
276      * @return FloatMass; scalar as a multiplication of FloatDuration and FloatFlowMass
277      */
278     public final FloatMass times(final FloatFlowMass v)
279     {
280         return new FloatMass(this.si * v.si, MassUnit.SI);
281     }
282 
283     /**
284      * Calculate the multiplication of FloatDuration and FloatFlowVolume, which results in a FloatVolume scalar.
285      * @param v FloatDuration; scalar
286      * @return FloatVolume; scalar as a multiplication of FloatDuration and FloatFlowVolume
287      */
288     public final FloatVolume times(final FloatFlowVolume v)
289     {
290         return new FloatVolume(this.si * v.si, VolumeUnit.SI);
291     }
292 
293     /**
294      * Calculate the multiplication of FloatDuration and FloatAcceleration, which results in a FloatSpeed scalar.
295      * @param v FloatDuration; scalar
296      * @return FloatSpeed; scalar as a multiplication of FloatDuration and FloatAcceleration
297      */
298     public final FloatSpeed times(final FloatAcceleration v)
299     {
300         return new FloatSpeed(this.si * v.si, SpeedUnit.SI);
301     }
302 
303     /**
304      * Calculate the multiplication of FloatDuration and FloatPower, which results in a FloatEnergy scalar.
305      * @param v FloatDuration; scalar
306      * @return FloatEnergy; scalar as a multiplication of FloatDuration and FloatPower
307      */
308     public final FloatEnergy times(final FloatPower v)
309     {
310         return new FloatEnergy(this.si * v.si, EnergyUnit.SI);
311     }
312 
313     /**
314      * Calculate the multiplication of FloatDuration and FloatSpeed, which results in a FloatLength scalar.
315      * @param v FloatDuration; scalar
316      * @return FloatLength; scalar as a multiplication of FloatDuration and FloatSpeed
317      */
318     public final FloatLength times(final FloatSpeed v)
319     {
320         return new FloatLength(this.si * v.si, LengthUnit.SI);
321     }
322 
323     /**
324      * Calculate the multiplication of FloatDuration and FloatElectricalPotential, which results in a FloatMagneticFlux scalar.
325      * @param v FloatDuration; scalar
326      * @return FloatMagneticFlux; scalar as a multiplication of FloatDuration and FloatElectricalPotential
327      */
328     public final FloatMagneticFlux times(final FloatElectricalPotential v)
329     {
330         return new FloatMagneticFlux(this.si * v.si, MagneticFluxUnit.SI);
331     }
332 
333     /**
334      * Calculate the multiplication of FloatDuration and FloatElectricalResistance, which results in a FloatElectricalInductance
335      * scalar.
336      * @param v FloatDuration; scalar
337      * @return FloatElectricalInductance; scalar as a multiplication of FloatDuration and FloatElectricalResistance
338      */
339     public final FloatElectricalInductance times(final FloatElectricalResistance v)
340     {
341         return new FloatElectricalInductance(this.si * v.si, ElectricalInductanceUnit.SI);
342     }
343 
344     /**
345      * Calculate the multiplication of FloatDuration and FloatElectricalConductance, which results in a
346      * FloatElectricalCapacitance scalar.
347      * @param v FloatDuration; scalar
348      * @return FloatElectricalCapacitance; scalar as a multiplication of FloatDuration and FloatElectricalConductance
349      */
350     public final FloatElectricalCapacitance times(final FloatElectricalConductance v)
351     {
352         return new FloatElectricalCapacitance(this.si * v.si, ElectricalCapacitanceUnit.SI);
353     }
354 
355     /**
356      * Calculate the multiplication of FloatDuration and FloatAngularVelocity, which results in a FloatAngle scalar.
357      * @param v FloatDuration; scalar
358      * @return FloatAngle; scalar as a multiplication of FloatDuration and FloatAngularVelocity
359      */
360     public final FloatAngle times(final FloatAngularVelocity v)
361     {
362         return new FloatAngle(this.si * v.si, AngleUnit.SI);
363     }
364 
365     /**
366      * Calculate the multiplication of FloatDuration and FloatAngularAcceleration, which results in a FloatAngularVelocity
367      * scalar.
368      * @param v FloatDuration; scalar
369      * @return FloatAngularVelocity; scalar as a multiplication of FloatDuration and FloatAngularAcceleration
370      */
371     public final FloatAngularVelocity times(final FloatAngularAcceleration v)
372     {
373         return new FloatAngularVelocity(this.si * v.si, AngularVelocityUnit.SI);
374     }
375 
376     /** {@inheritDoc} */
377     @Override
378     public FloatFrequency reciprocal()
379     {
380         return FloatFrequency.instantiateSI(1.0f / this.si);
381     }
382 
383 }