Classes représentant des unités. Les classes de ce paquet servent à satisfaire une règle d'or en science, qui veut que l'on écrive toujours les unités d'une valeur. Pour un programme informatique, il n'est pas satisfaisant de représenter des unités par une simple chaîne de caractères (par exemple "°C"), car alors l'ordinateur ne saurait pas comment faire les conversions entre différentes unités (par exemple de "°F" vers "°C"). La classe {@link org.geotools.units.Unit} est un moyen plus efficace de représenter une unité. Un objet {@link org.geotools.units.Unit} est capable par exemple de convertir une valeur à partir d'une autre unité.

On peut obtenir un objet {@link org.geotools.units.Unit} à partir de son symbole. Par exemple le code {@link org.geotools.units.Unit#get(String) Unit.get}("°C") retournera un objet {@link org.geotools.units.Unit} qui représente les degrés celcius. Le tableau ci-dessous énumère les unités reconnues par défaut. La plupart des définitions ci-dessous proviennent de la documentation officielle du bureau international des poids et mesures. Les symboles apparaissant dans ce tableau sont les symboles officiels pour ces unités, sauf ceux qui sont marqués d'un astérix (*).

    * Ce symbole n'est pas standard.

La plupart des unités SI peuvent aussi être précédes d'un préfix. Par exemple si le symbole "Pa" désigne les pascals, alors le symbole "kPa" sera reconnu comme désignant les kilopascals. Le tableau ci-dessous énumère les préfix standards du système SI.

Il est possible d'utiliser des symboles qui multiplient et divisent des unités. Par exemple des symboles tels que "g/cm" sont valides et seront reconnus. Toutes les unités sont construites à partir d'un ensemble restreint d'unités de base:

D'autres unités qui ne sont pas réellement des unités de bases (par exemple les moles, radians ou la salinité) peuvent être définies comme telles par commodité.

Les constructeurs des classes du paquet org.geotools.units n'étant pas publiques, on ne peut pas créer directement de nouvelles unités. La création d'une nouvelle unité doit se faire de façon indirecte en combinant les opérations {@link org.geotools.units.Unit#scale} et {@link org.geotools.units.Unit#shift} sur une ancienne unité. Par exemple on peut créer des unités de miles nautiques avec:

{@link org.geotools.units.Unit Unit} mile=METRE.{@link org.geotools.units.Unit#scale scale}(1853);

Ce code signifie qu'un mile nautique correspond à 1.853 kilomètres. Comme autre exemple, si degC représente les degrés Celsius, alors on peut créer des unités pour les degrés Fahrenheit à l'aide du code suivant:

{@link org.geotools.units.Unit Unit} degF = degC.{@link org.geotools.units.Unit#scale scale}(5./9).{@link org.geotools.units.Unit#shift shift}(-32);

Ce code signifie que pour convertir des degrés Celsius en degrés Fahrenheit, il faudra d'abord diviser par 5/9 les degrés Celsius et ensuite ajouter 32. Une autre façon d'interpréter ce code est de le lire en sens inverse: à partir des degrés Fahrenheit, on retranche 32 et on multiplie par 5/9 pour obtenir des degrés Celsius.

Il est aussi possible d'utiliser les méthodes de {@link org.geotools.units.Unit} pour transformer des unités inconnus en unités d'une autre dimension. Par exemple supposons que l'on dispose d'unités de temps pour les mesures de la période d'un signal, et que l'on veut les transformer en unités de fréquences et de vitesses. On pourrait écrire:

Unit timeUnit      = Unit.get("min"); // Minutes, juste en guise d'exemple
Unit frequencyUnit = timeUnit.pow(-1);
Unit speedUnit     = get("km").multiply(frequencyUnit);

Ce code fonctionnera même si les unités de timeUnit ne sont pas connues à l'avance.

Toutes les classes de ce paquet sont immutables et sécuritaires dans un environnement multi-threads, ce qui implique que l'on peut sans crainte partager plusieurs références vers une même unité. Toutes les méthodes de ce paquet sont définies de façon à partager autant que possibles les mêmes références, ce qui réduit la consommation de mémoire.