View Javadoc
1   package org.djunits.value.vdouble.vector;
2   
3   import java.util.List;
4   import java.util.SortedMap;
5   
6   import org.djunits.unit.LengthUnit;
7   import org.djunits.unit.PositionUnit;
8   import org.djunits.value.StorageType;
9   import org.djunits.value.ValueException;
10  import org.djunits.value.vdouble.scalar.Position;
11  
12  /**
13   * Mutable Absolute Position Vector.
14   * <p>
15   * Copyright (c) 2013-2018 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
16   * BSD-style license. See <a href="http://djunits.org/docs/license.html">DJUNITS License</a>.
17   * <p>
18   * $LastChangedDate: 2015-09-29 14:14:28 +0200 (Tue, 29 Sep 2015) $, @version $Revision: 73 $, by $Author: pknoppers $, initial
19   * version Sep 5, 2015 <br>
20   * @author <a href="http://www.tbm.tudelft.nl/averbraeck">Alexander Verbraeck</a>
21   * @author <a href="http://www.tudelft.nl/pknoppers">Peter Knoppers</a>
22   */
23  public class MutablePositionVector extends
24          AbstractMutableDoubleVectorAbs<PositionUnit, LengthUnit, PositionVector, LengthVector, MutablePositionVector, Position>
25  {
26      /** */
27      private static final long serialVersionUID = 20151003L;
28  
29      /**
30       * Construct a new Absolute Mutable Double PositionVector.
31       * @param values double[]; the values of the entries in the new Absolute Mutable Double PositionVector
32       * @param unit U; the unit of the new Absolute Mutable Double PositionVector
33       * @param storageType the data type to use (e.g., DENSE or SPARSE)
34       * @throws ValueException when values is null
35       */
36      public MutablePositionVector(final double[] values, final PositionUnit unit, final StorageType storageType)
37              throws ValueException
38      {
39          super(values, unit, storageType);
40      }
41  
42      /**
43       * Construct a new Absolute Mutable Double PositionVector.
44       * @param values List; the values of the entries in the new Absolute Mutable Double PositionVector
45       * @param unit U; the unit of the new Absolute Mutable Double PositionVector
46       * @param storageType the data type to use (e.g., DENSE or SPARSE)
47       * @throws ValueException when values is null
48       */
49      public MutablePositionVector(final List<Double> values, final PositionUnit unit, final StorageType storageType)
50              throws ValueException
51      {
52          super(values, unit, storageType);
53      }
54  
55      /**
56       * Construct a new Absolute Mutable Double PositionVector.
57       * @param values DoubleScalar.Rel&lt;U&gt;[]; the values of the entries in the new Absolute Mutable Double PositionVector
58       * @param storageType the data type to use (e.g., DENSE or SPARSE)
59       * @throws ValueException when values has zero entries
60       */
61      public MutablePositionVector(final Position[] values, final StorageType storageType) throws ValueException
62      {
63          super(values, storageType);
64      }
65  
66      /**
67       * Construct a new Absolute Mutable Double PositionVector.
68       * @param values List; the values of the entries in the new Absolute Mutable Double PositionVector
69       * @param storageType the data type to use (e.g., DENSE or SPARSE)
70       * @throws ValueException when values has zero entries
71       */
72      public MutablePositionVector(final List<Position> values, final StorageType storageType) throws ValueException
73      {
74          super(values, storageType);
75      }
76  
77      /**
78       * Construct a new Absolute Mutable Double PositionVector.
79       * @param values DoubleScalar.Rel&lt;U&gt;[]; the values of the entries in the new Absolute Sparse Mutable Double
80       *            PositionVector
81       * @param length the size of the vector
82       * @param storageType the data type to use (e.g., DENSE or SPARSE)
83       * @throws ValueException when values has zero entries
84       */
85      public MutablePositionVector(final SortedMap<Integer, Position> values, final int length, final StorageType storageType)
86              throws ValueException
87      {
88          super(values, length, storageType);
89      }
90  
91      /**
92       * Construct a new Absolute Mutable Double PositionVector.
93       * @param values Map; the map of indexes to values of the Absolute Sparse Mutable Double PositionVector
94       * @param unit U; the unit of the new Absolute Sparse Mutable Double PositionVector
95       * @param length the size of the vector
96       * @param storageType the data type to use (e.g., DENSE or SPARSE)
97       * @throws ValueException when values is null
98       */
99      public MutablePositionVector(final SortedMap<Integer, Double> values, final PositionUnit unit, final int length,
100             final StorageType storageType) throws ValueException
101     {
102         super(values, unit, length, storageType);
103     }
104 
105     /**
106      * Construct a new Absolute Mutable Double PositionVector.
107      * @param data an internal data object
108      * @param unit the unit
109      */
110     MutablePositionVector(final DoubleVectorData data, final PositionUnit unit)
111     {
112         super(data, unit);
113     }
114 
115     /** {@inheritDoc} */
116     @Override
117     protected final PositionVector instantiateTypeAbs(final DoubleVectorData dvd, final PositionUnit unit)
118     {
119         return new PositionVector(dvd, unit);
120     }
121 
122     /** {@inheritDoc} */
123     @Override
124     protected final LengthVector instantiateTypeRel(final DoubleVectorData dvd, final LengthUnit unit)
125     {
126         return new LengthVector(dvd, unit);
127     }
128 
129     /** {@inheritDoc} */
130     @Override
131     protected final MutablePositionVector instantiateMutableType(final DoubleVectorData dvd, final PositionUnit unit)
132     {
133         return new MutablePositionVector(dvd, unit);
134     }
135 
136     /** {@inheritDoc} */
137     @Override
138     protected final Position instantiateScalar(final double value, final PositionUnit unit)
139     {
140         return new Position(value, unit);
141     }
142 
143     /** {@inheritDoc} */
144     @Override
145     public final MutablePositionVector toDense()
146     {
147         return this.data.isDense() ? (MutablePositionVector) this : instantiateMutableType(this.data.toDense(), getUnit());
148     }
149 
150     /** {@inheritDoc} */
151     @Override
152     public final MutablePositionVector toSparse()
153     {
154         return this.data.isSparse() ? (MutablePositionVector) this : instantiateMutableType(this.data.toSparse(), getUnit());
155     }
156 
157     /**
158      * Return an array of Position Scalars from this vector.
159      * @return Position[]; an array of Position Scalars from this vector
160      * @throws RuntimeException wrapping a ValueException on error getting one of the values
161      */
162     public Position[] toArray()
163     {
164         Position[] array = new Position[size()];
165         for (int i = 0; i < size(); i++)
166         {
167             try
168             {
169                 array[i] = get(i);
170             }
171             catch (ValueException exception)
172             {
173                 throw new RuntimeException(exception);
174             }
175         }
176         return array;
177     }
178 
179 }