1 package org.djunits.value.vfloat.vector.base; 2 3 import org.djunits.unit.AbsoluteLinearUnit; 4 import org.djunits.unit.Unit; 5 import org.djunits.value.Absolute; 6 import org.djunits.value.ValueRuntimeException; 7 import org.djunits.value.vfloat.function.FloatMathFunctions; 8 import org.djunits.value.vfloat.scalar.base.FloatScalarAbs; 9 import org.djunits.value.vfloat.scalar.base.FloatScalarRelWithAbs; 10 import org.djunits.value.vfloat.vector.data.FloatVectorData; 11 12 /** 13 * AbstractMutableFloatVectorRelWithAbs.java. 14 * <p> 15 * Copyright (c) 2019-2024 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br> 16 * BSD-style license. See <a href="https://djunits.org/docs/license.html">DJUNITS License</a>. 17 * </p> 18 * @author <a href="https://www.tudelft.nl/averbraeck" target="_blank">Alexander Verbraeck</a> 19 * @param <AU> the absolute unit belonging to the relative unit 20 * @param <A> the absolute scalar type belonging to the absolute vector type 21 * @param <AV> the (immutable or mutable) absolute vector type 22 * @param <RU> the relative unit belonging to the absolute unit 23 * @param <R> the relative scalar type belonging to the relative vector type 24 * @param <RV> the relative (immutable or mutable) vector type with this unit 25 */ 26 // @formatter:off 27 public abstract class FloatVectorAbs< 28 AU extends AbsoluteLinearUnit<AU, RU>, 29 A extends FloatScalarAbs<AU, A, RU, R>, 30 AV extends FloatVectorAbs<AU, A, AV, RU, R, RV>, 31 RU extends Unit<RU>, 32 R extends FloatScalarRelWithAbs<AU, A, RU, R>, 33 RV extends FloatVectorRelWithAbs<AU, A, AV, RU, R, RV>> 34 extends FloatVector<AU, A, AV> 35 implements Absolute<AU, AV, RU, RV> 36 // @formatter:on 37 { 38 /** */ 39 private static final long serialVersionUID = 20190908L; 40 41 /** 42 * Construct a new Relative Mutable FloatVector. 43 * @param data FloatVectorData; an internal data object 44 * @param unit AU; the unit 45 */ 46 protected FloatVectorAbs(final FloatVectorData data, final AU unit) 47 { 48 super(data.copy(), unit); 49 } 50 51 @Override 52 public AV plus(final RV increment) throws ValueRuntimeException 53 { 54 return instantiateVector(this.getData().plus(increment.getData()), getDisplayUnit()); 55 } 56 57 @Override 58 public AV minus(final RV decrement) throws ValueRuntimeException 59 { 60 return instantiateVector(this.getData().minus(decrement.getData()), getDisplayUnit()); 61 } 62 63 @Override 64 public RV minus(final AV decrement) throws ValueRuntimeException 65 { 66 return instantiateVectorRel(this.getData().minus(decrement.getData()), decrement.getDisplayUnit().getRelativeUnit()); 67 } 68 69 /** 70 * Decrement all values of this vector by the decrement. This only works if the vector is mutable. 71 * @param decrement R; the scalar by which to decrement all values 72 * @return AV; this modified vector 73 * @throws ValueRuntimeException in case this vector is immutable 74 */ 75 @SuppressWarnings("unchecked") 76 public AV decrementBy(final R decrement) 77 { 78 checkCopyOnWrite(); 79 assign(FloatMathFunctions.DEC(decrement.si)); 80 return (AV) this; 81 } 82 83 /** 84 * Decrement all values of this vector by the decrement on a value by value basis. This only works if this vector is 85 * mutable. 86 * @param decrement RV; the vector that contains the values by which to decrement the corresponding values 87 * @return AV; this modified vector 88 * @throws ValueRuntimeException in case this vector is immutable or when the sizes of the vectors differ 89 */ 90 @SuppressWarnings("unchecked") 91 public AV decrementBy(final RV decrement) 92 { 93 checkCopyOnWrite(); 94 getData().decrementBy(decrement.getData()); 95 return (AV) this; 96 } 97 98 /** 99 * Instantiate a new relative vector of the class of this absolute vector. This can be used instead of the 100 * FloatVector.instiantiate() methods in case another vector of this absolute vector class is known. The method is faster 101 * than FloatVector.instantiate, and it will also work if the vector is user-defined. 102 * @param dvd FloatVectorData; the data used to instantiate the vector 103 * @param displayUnit RU; the display unit of the relative vector 104 * @return RV; a relative vector of the correct type, belonging to this absolute vector type 105 */ 106 public abstract RV instantiateVectorRel(FloatVectorData dvd, RU displayUnit); 107 108 /** 109 * Instantiate a new relative scalar for the class of this absolute vector. This can be used instead of the 110 * FloatScalar.instiantiate() methods in case a vector of this class is known. The method is faster than 111 * FloatScalar.instantiate, and it will also work if the vector and/or scalar are user-defined. 112 * @param valueSI float; the SI value of the relative scalar 113 * @param displayUnit RU; the unit in which the relative value will be displayed 114 * @return R; a relative scalar of the correct type, belonging to this absolute vector type 115 */ 116 public abstract R instantiateScalarRelSI(float valueSI, RU displayUnit); 117 118 }