View Javadoc
1   package org.djutils.serialization;
2   
3   import java.io.Serializable;
4   import java.util.HashMap;
5   import java.util.Map;
6   import java.util.Objects;
7   
8   import org.djunits.unit.AbsoluteTemperatureUnit;
9   import org.djunits.unit.AbsorbedDoseUnit;
10  import org.djunits.unit.AccelerationUnit;
11  import org.djunits.unit.AmountOfSubstanceUnit;
12  import org.djunits.unit.AngleUnit;
13  import org.djunits.unit.AngularAccelerationUnit;
14  import org.djunits.unit.AngularVelocityUnit;
15  import org.djunits.unit.AreaUnit;
16  import org.djunits.unit.CatalyticActivityUnit;
17  import org.djunits.unit.DensityUnit;
18  import org.djunits.unit.DimensionlessUnit;
19  import org.djunits.unit.DirectionUnit;
20  import org.djunits.unit.DurationUnit;
21  import org.djunits.unit.ElectricalCapacitanceUnit;
22  import org.djunits.unit.ElectricalChargeUnit;
23  import org.djunits.unit.ElectricalConductanceUnit;
24  import org.djunits.unit.ElectricalCurrentUnit;
25  import org.djunits.unit.ElectricalInductanceUnit;
26  import org.djunits.unit.ElectricalPotentialUnit;
27  import org.djunits.unit.ElectricalResistanceUnit;
28  import org.djunits.unit.EnergyUnit;
29  import org.djunits.unit.EquivalentDoseUnit;
30  import org.djunits.unit.FlowMassUnit;
31  import org.djunits.unit.FlowVolumeUnit;
32  import org.djunits.unit.ForceUnit;
33  import org.djunits.unit.FrequencyUnit;
34  import org.djunits.unit.IlluminanceUnit;
35  import org.djunits.unit.LengthUnit;
36  import org.djunits.unit.LinearDensityUnit;
37  import org.djunits.unit.LuminousFluxUnit;
38  import org.djunits.unit.LuminousIntensityUnit;
39  import org.djunits.unit.MagneticFluxDensityUnit;
40  import org.djunits.unit.MagneticFluxUnit;
41  import org.djunits.unit.MassUnit;
42  import org.djunits.unit.MomentumUnit;
43  import org.djunits.unit.PositionUnit;
44  import org.djunits.unit.PowerUnit;
45  import org.djunits.unit.PressureUnit;
46  import org.djunits.unit.RadioActivityUnit;
47  import org.djunits.unit.SolidAngleUnit;
48  import org.djunits.unit.SpeedUnit;
49  import org.djunits.unit.TemperatureUnit;
50  import org.djunits.unit.TimeUnit;
51  import org.djunits.unit.TorqueUnit;
52  import org.djunits.unit.Unit;
53  import org.djunits.unit.VolumeUnit;
54  
55  /**
56   * The unit types with their code, including static methods to quickly find a unit type.
57   * <p>
58   * Copyright (c) 2016-2025 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved. <br>
59   * BSD-style license. See <a href="https://sim0mq.org/docs/current/license.html">Sim0MQ License</a>.
60   * </p>
61   * @author <a href="https://www.tudelft.nl/averbraeck">Alexander Verbraeck</a>
62   */
63  public class SerializationUnits implements Serializable
64  {
65      /** */
66      private static final long serialVersionUID = 20170304L;
67  
68      /** the unit types from number to type. */
69      private static Map<Byte, SerializationUnits> byteTypeMap = new HashMap<>();
70  
71      /** the unit types from class to type. */
72      private static Map<Class<? extends Unit<?>>, SerializationUnits> unitTypeMap = new HashMap<>();
73  
74      /** Dimensionless unit type with code 0. */
75      public static final SerializationUnits DIMENSIONLESS =
76              new SerializationUnits(0, DimensionlessUnit.class, "Dimensionless", "Unit without a dimension", "[]");
77  
78      /** Acceleration unit type with code 1. */
79      public static final SerializationUnits ACCELERATION =
80              new SerializationUnits(1, AccelerationUnit.class, "Acceleration", "Acceleration", "[m/s^2]");
81  
82      /** SolidAngle unit type with code 2. */
83      public static final SerializationUnits SOLIDANGLE =
84              new SerializationUnits(2, SolidAngleUnit.class, "SolidAngle", "Solid angle (steradian)", "[sr]");
85  
86      /** Angle unit type with code 3. */
87      public static final SerializationUnits ANGLE =
88              new SerializationUnits(3, AngleUnit.class, "Angle", "Angle (relative)", "[rad]");
89  
90      /** Direction unit type with code 4. */
91      public static final SerializationUnits DIRECTION =
92              new SerializationUnits(4, DirectionUnit.class, "Direction", "Angle (absolute)", "[rad]");
93  
94      /** Area unit type with code 5. */
95      public static final SerializationUnits AREA = new SerializationUnits(5, AreaUnit.class, "Area", "Area (m2)", "[m^2]");
96  
97      /** Density unit type with code 6. */
98      public static final SerializationUnits DENSITY =
99              new SerializationUnits(6, DensityUnit.class, "Density", "Density based on mass and length", "[kg/m^3]");
100 
101     /** ElectricalCharge unit type with code 7. */
102     public static final SerializationUnits ELECTRICALCHARGE =
103             new SerializationUnits(7, ElectricalChargeUnit.class, "ElectricalCharge", "Electrical charge (Coulomb)", "[s.A]");
104 
105     /** ElectricalCurrent unit type with code 8. */
106     public static final SerializationUnits ELECTRICALCURRENT =
107             new SerializationUnits(8, ElectricalCurrentUnit.class, "ElectricalCurrent", "Electrical current (Ampere)", "[A]");
108 
109     /** ElectricalPotential unit type with code 9. */
110     public static final SerializationUnits ELECTRICALPOTENTIAL = new SerializationUnits(9, ElectricalPotentialUnit.class,
111             "ElectricalPotential", "Electrical potential (Volt)", "[kg.m^2/s^3.A]");
112 
113     /** ElectricalResistance unit type with code 10. */
114     public static final SerializationUnits ELECTRICALRESISTANCE = new SerializationUnits(10, ElectricalResistanceUnit.class,
115             "ElectricalResistance", "Electrical resistance (Ohm)", "[kg.m^2/s^3.A^2]");
116 
117     /** Energy unit type with code 11. */
118     public static final SerializationUnits ENERGY =
119             new SerializationUnits(11, EnergyUnit.class, "Energy", "Energy (Joule)", "[kg.m^2/s^2]");
120 
121     /** FlowMass unit type with code 12. */
122     public static final SerializationUnits FLOWMASS =
123             new SerializationUnits(12, FlowMassUnit.class, "FlowMass", "Mass flow rate ", "[kg/s]");
124 
125     /** FlowVolume unit type with code 13. */
126     public static final SerializationUnits FLOWVOLUME =
127             new SerializationUnits(13, FlowVolumeUnit.class, "FlowVolume", "Volume flow rate", "[m^3/s]");
128 
129     /** Force unit type with code 14. */
130     public static final SerializationUnits FORCE =
131             new SerializationUnits(14, ForceUnit.class, "Force", "Force (Newton)", "[kg.m/s^2]");
132 
133     /** Frequency unit type with code 15. */
134     public static final SerializationUnits FREQUENCY =
135             new SerializationUnits(15, FrequencyUnit.class, "Frequency", "Frequency (Hz)", "[1/s]");
136 
137     /** Length unit type with code 16. */
138     public static final SerializationUnits LENGTH =
139             new SerializationUnits(16, LengthUnit.class, "Length", "Length (relative)", "[m]");
140 
141     /** Position unit type with code 17. */
142     public static final SerializationUnits POSITION =
143             new SerializationUnits(17, PositionUnit.class, "Position", "Length (absolute)", "[m]");
144 
145     /** LinearDensity unit type with code 18. */
146     public static final SerializationUnits LINEARDENSITY =
147             new SerializationUnits(18, LinearDensityUnit.class, "LinearDensity", "Linear density ", "[1/m]");
148 
149     /** Mass unit type with code 19. */
150     public static final SerializationUnits MASS = new SerializationUnits(19, MassUnit.class, "Mass", "Mass", "[kg]");
151 
152     /** Power unit type with code 20. */
153     public static final SerializationUnits POWER =
154             new SerializationUnits(20, PowerUnit.class, "Power", "Power (Watt)", "[kg.m^2/s^3]");
155 
156     /** Pressure unit type with code 21. */
157     public static final SerializationUnits PRESSURE =
158             new SerializationUnits(21, PressureUnit.class, "Pressure", "Pressure (Pascal)", "[kg/m.s^2]");
159 
160     /** Speed unit type with code 22. */
161     public static final SerializationUnits SPEED = new SerializationUnits(22, SpeedUnit.class, "Speed", "Speed", "[m/s]");
162 
163     /** Temperature unit type with code 23. */
164     public static final SerializationUnits TEMPERATURE =
165             new SerializationUnits(23, TemperatureUnit.class, "Temperature", "Temperature (relative)", "[K]");
166 
167     /** AbsoluteTemperature unit type with code 24. */
168     public static final SerializationUnits ABSOLUTETEMPERATURE =
169             new SerializationUnits(24, AbsoluteTemperatureUnit.class, "AbsoluteTemperature", "Temperature (absolute)", "[K]");
170 
171     /** Duration unit type with code 25. */
172     public static final SerializationUnits DURATION =
173             new SerializationUnits(25, DurationUnit.class, "Duration", "Time (relative)", "[s]");
174 
175     /** Time unit type with code 26. */
176     public static final SerializationUnits TIME = new SerializationUnits(26, TimeUnit.class, "Time", "Time (absolute)", "[s]");
177 
178     /** Torque unit type with code 27. */
179     public static final SerializationUnits TORQUE =
180             new SerializationUnits(27, TorqueUnit.class, "Torque", "Torque (Newton-meter)", "[kg.m^2/s^2]");
181 
182     /** Volume unit type with code 28. */
183     public static final SerializationUnits VOLUME = new SerializationUnits(28, VolumeUnit.class, "Volume", "Volume", "[m^3]");
184 
185     /** AbsorbedDose unit type with code 29. */
186     public static final SerializationUnits ABSORBEDDOSE =
187             new SerializationUnits(28, AbsorbedDoseUnit.class, "Absorbed dose", "Absorbed Dose (Gray)", "[m^2/s^2]");
188 
189     /** AmountOfSubstance unit type with code 30. */
190     public static final SerializationUnits AMOUNTOFSUBSTANCE = new SerializationUnits(30, AmountOfSubstanceUnit.class,
191             "Amount of substance", "Amount of substance (mole)", "[mol]");
192 
193     /** CatalyticActivity unit type with code 31. */
194     public static final SerializationUnits CATALYTICACTIVITY = new SerializationUnits(31, CatalyticActivityUnit.class,
195             "Catalytic activity", "Catalytic activity (katal)", "[mol/s]");
196 
197     /** ElectricalCapacitance unit type with code 32. */
198     public static final SerializationUnits ELECTRICALCAPACITANCE = new SerializationUnits(32, ElectricalCapacitanceUnit.class,
199             "Electrical capacitance", "Electrical capacitance (Farad)", "[s^4.A^2/kg.m^2]");
200 
201     /** ElectricalConductance unit type with code 33. */
202     public static final SerializationUnits ELECTRICALCONDUCTANCE = new SerializationUnits(33, ElectricalConductanceUnit.class,
203             "Electrical conductance", "Electrical conductance (Siemens)", "[s^3.A^2/kg.m^2]");
204 
205     /** ElectricalInductance unit type with code 34. */
206     public static final SerializationUnits ELECTRICALINDUCTANCE = new SerializationUnits(34, ElectricalInductanceUnit.class,
207             "Electrical inductance", "Electrical inductance (Henry)", "[kg.m^2/s^2.A^2]");
208 
209     /** EquivalentDose unit type with code 35. */
210     public static final SerializationUnits EQUIVALENTDOSE =
211             new SerializationUnits(35, EquivalentDoseUnit.class, "Equivalent dose", "Equivalent dose (Sievert)", "[m^2/s^2]");
212 
213     /** Illuminance unit type with code 36. */
214     public static final SerializationUnits ILLUMINANCE =
215             new SerializationUnits(36, IlluminanceUnit.class, "Illuminance", "Illuminance (lux)", "[sr.cd/m^2]");
216 
217     /** LuminousFlux unit type with code 37. */
218     public static final SerializationUnits LUMINOUSFLUX =
219             new SerializationUnits(37, LuminousFluxUnit.class, "Luminous flux", "Luminous flux (lumen)", "[sr.cd]");
220 
221     /** LuminousIntensity unit type with code 38. */
222     public static final SerializationUnits LUMINOUSINTENSITY = new SerializationUnits(38, LuminousIntensityUnit.class,
223             "Luminous intensity", "Luminous intensity (candela)", "[cd]");
224 
225     /** MagneticFluxDensity unit type with code 39. */
226     public static final SerializationUnits MAGNETICFLUXDENSITY = new SerializationUnits(39, MagneticFluxDensityUnit.class,
227             "Magnetic flux density", "Magnetic flux density (Tesla)", "[kg/s^2.A]");
228 
229     /** MagneticFlux unit type with code 40. */
230     public static final SerializationUnits MAGNETICFLUX =
231             new SerializationUnits(40, MagneticFluxUnit.class, "Magnetic flux", "Magnetic flux (Weber)", "[kg.m^2/s^2.A]");
232 
233     /** RadioActivity unit type with code 41. */
234     public static final SerializationUnits RADIOACTIVITY =
235             new SerializationUnits(41, RadioActivityUnit.class, "Radioactivity", "Radioactivity (Becquerel)", "[1/s]");
236 
237     /** AngularAcceleration unit type with code 42. */
238     public static final SerializationUnits ANGULARACCELERATION = new SerializationUnits(42, AngularAccelerationUnit.class,
239             "AngularAcceleration", "AngularAcceleration", "[rad/s^2]");
240 
241     /** AngularVelocity unit type with code 43. */
242     public static final SerializationUnits ANGULARVELOCITY =
243             new SerializationUnits(43, AngularVelocityUnit.class, "AngularVelocity", "AngularVelocity", "[rad/s]");
244 
245     /** AngularAcceleration unit type with code 44. */
246     public static final SerializationUnits MOMENTUM =
247             new SerializationUnits(44, MomentumUnit.class, "Momentum", "Momentum", "[rad/s^2]");
248 
249     /** The code of the unit as a byte. */
250     private final byte code;
251 
252     /** The djunits data type. */
253     private final Class<? extends Unit<?>> djunitsType;
254 
255     /** The unit name. */
256     private final String name;
257 
258     /** The unit description. */
259     private final String description;
260 
261     /** The SI or default unit in SI-elements. */
262     private final String siUnit;
263 
264     /**
265      * Construct a new UnitType and put it in the maps.
266      * @param code the byte code of the unit provided as an int
267      * @param djunitsType the djunits data type
268      * @param name the unit name
269      * @param description the unit description
270      * @param siUnit the SI or default unit in SI-elements
271      * @param <U> the Unit
272      */
273     public <U extends Unit<U>> SerializationUnits(final int code, final Class<U> djunitsType, final String name,
274             final String description, final String siUnit)
275     {
276         this.code = (byte) code;
277         this.djunitsType = djunitsType;
278         this.name = name;
279         this.description = description;
280         this.siUnit = siUnit;
281 
282         byteTypeMap.put(this.code, this);
283         unitTypeMap.put(this.djunitsType, this);
284     }
285 
286     /**
287      * Return the unit type belonging to the byte code.
288      * @param code the code to search for.
289      * @return the unit type, or null if not found.
290      */
291     public static SerializationUnits getUnitType(final byte code)
292     {
293         return byteTypeMap.get(code);
294     }
295 
296     /**
297      * Return the unit class belonging to the byte code.
298      * @param code the code to search for.
299      * @return the unit class, or null if not found.
300      */
301     public static Class<? extends Unit<?>> getUnitClass(final byte code)
302     {
303         SerializationUnits type = byteTypeMap.get(code);
304         return type == null ? null : type.getDjunitsType();
305     }
306 
307     /**
308      * Return the unit type belonging to the unit class.
309      * @param unit the unit to search for.
310      * @return the unit type, or null if not found.
311      * @param <U> the Unit
312      */
313     public static <U extends Unit<U>> SerializationUnits getUnitType(final U unit)
314     {
315         return unitTypeMap.get(unit.getClass());
316     }
317 
318     /**
319      * Return the byte code belonging to the unit class.
320      * @param unit the unit to search for.
321      * @return the unit type code, or null if not found.
322      * @param <U> the Unit
323      * @throws IllegalArgumentException when unit type could not be found
324      */
325     public static <U extends Unit<U>> byte getUnitCode(final U unit)
326     {
327         SerializationUnits type = unitTypeMap.get(unit.getClass());
328         if (type == null)
329         {
330             throw new IllegalArgumentException("Could not find unit type for unit " + unit + " in unitTypeMap");
331         }
332         return type.getCode();
333     }
334 
335     /**
336      * Retrieve the byte code of this UnitType.
337      * @return the byte code of this UnitType
338      */
339     public final byte getCode()
340     {
341         return this.code;
342     }
343 
344     /**
345      * Retrieve the DJUNITS type of this UnitType.
346      * @return the DJUNITS type of this UnitType
347      */
348     public final Class<? extends Unit<?>> getDjunitsType()
349     {
350         return this.djunitsType;
351     }
352 
353     /**
354      * Retrieve the name of the UnitType.
355      * @return the name of this UnitType
356      */
357     public final String getName()
358     {
359         return this.name;
360     }
361 
362     /**
363      * Retrieve the description of this UnitType.
364      * @return the description of this UnitType
365      */
366     public final String getDescription()
367     {
368         return this.description;
369     }
370 
371     /**
372      * Retrieve the SI unit of this UnitType.
373      * @return String the SI unit of this UnitType
374      */
375     public final String getSiUnit()
376     {
377         return this.siUnit;
378     }
379 
380     @SuppressWarnings("checkstyle:designforextension")
381     @Override
382     public int hashCode()
383     {
384         return Objects.hash(this.code, this.description, this.djunitsType, this.name, this.siUnit);
385     }
386 
387     @SuppressWarnings({"checkstyle:designforextension", "needbraces"})
388     @Override
389     public boolean equals(final Object obj)
390     {
391         if (this == obj)
392             return true;
393         if (obj == null)
394             return false;
395         if (getClass() != obj.getClass())
396             return false;
397         SerializationUnits other = (SerializationUnits) obj;
398         return this.code == other.code && Objects.equals(this.description, other.description)
399                 && Objects.equals(this.djunitsType, other.djunitsType) && Objects.equals(this.name, other.name)
400                 && Objects.equals(this.siUnit, other.siUnit);
401     }
402 
403     @Override
404     @SuppressWarnings("checkstyle:designforextension")
405     public String toString()
406     {
407         return "UnitType [code=" + this.code + ", name=" + this.name + ", description=" + this.description + ", siUnit="
408                 + this.siUnit + "]";
409     }
410 
411 }