Package org.geotools.units

Represents an unit of a physical measure.

See:
Description

Class Summary

Unit	Deprecated. Replaced by the Unit framework.
UnitTransform	Deprecated. Replaced by the Unit framework.

Exception Summary

UnitException

Deprecated. Replaced by the Unit framework.

Package org.geotools.units Description

Represents an unit of a physical measure. The org.geotools.units package is a temporary placeholder for the upcomming javax.units package.

THIS TEMPORARY PACKAGE WILL BE FULLY DELETED WHEN THE REAL JSR-108: Units specification WILL BE PUBLICLY AVAILABLE. THE REAL JSR-108 SPECIFICATION WILL BE INCOMPATIBLE WITH THIS TEMPORARY IMPLEMENTATION.

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 Unit est un moyen plus efficace de repr?senter une unit?. Un objet Unit est capable par exemple de convertir une valeur ? partir d'une autre unit?.

On peut obtenir un objet Unit ? partir de son symbole. Par exemple le code Unit.get("?C") retournera un objet 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 (*).

Unit?s de base
m	Unit? de longueur (metre). Le m?tre est la longueur du trajet parcouru dans le vide par la lumi?re pendant une dur?e de 1/299 792 458 de seconde.
kg	Unit? de masse (klogramme). Le kilogramme est l'unit? de masse; il est ?gal ? la masse du prototype international du kilogramme.
s	Unit? de temps (seconde). La seconde est la dur?e de 9 192 631 770 p?riodes de la radiation correspondant ? la transition entre les deux niveaux hyperfins de l'?tat fonda-mental de l'atome de c?sium 133. Cette d?finition se r?f?re ? un atome de c?sium au repos, ? une temp?rature de 0 K.
A	Unit? de courant ?lectrique (amp?re). L'amp?re est l'intensit? d'un courant constant qui, maintenu dans deux conducteurs parall?les, rectilignes, de longueur infinie, de section circulaire n?gligeable et plac?s ? une distance de 1 m?tre l'un de l'autre dans le vide, produirait entre ces conducteurs une force ?gale ? 2x10-7 newton par m?tre de longueur.
K	Unit? de temp?rature thermodynamique (kelvin). Le kelvin, unit? de temp?rature thermodynamique, est la fraction 1/273,16 de la temp?rature thermodynamique du point triple de l'eau. La valeur num?rique d'une temp?rature Celsius t exprim?e en degr?s Celsius est donn?e par la relation: t/?C = T/K - 273,15.
mol	Unit? de quantit? de mati?re (mole). La mole est la quantit? de mati?re d'un syst?me contenant autant d'entit?s ?l?mentaires qu'il y a d'atomes dans 0,012 kilogramme de carbone 12; son symbole est ? mol ?. Lorsqu'on emploie la mole, les entit?s ?l?mentaires doivent ?tre sp?cifi?es et peuvent ?tre des atomes, des mol?cules, des ions, des ?lectrons, d'autres particules ou des groupements sp?cifi?s de telles particules.
cd	Unit? d'intensit? lumineuse (candela). La candela est l'intensit? lumineuse, dans une direction donn?e, d'une source qui ?met un rayonnement monochromatique de fr?quence 540x1012 Hertz et dont l'intensit? ?nerg?tique dans cette direction est 1/683 watt par st?radian.
rad	Unit? d'angle plan (radian). The radian is the plane angle between two radii of a circle that cut off on the circumference an arc equal in length to the radius.
sr	Unit? d'angle solide (st?radian).
PSS78*	Unit? de la salinit? de l'eau de mer. Pour ?tre strict, les mesures de salinit?s n'ont aucune unit? puisqu'elles sont calcul?es ? partir d'un rapport de conductivit?. Mais il est toutefois pratique de consid?rer la salinit? comme si elle avait une unit?, afin de rendre plus facile certaines v?rifications et conversions.
Unit?s d?riv?es
Hz	Unit? de fr?quence (Hertz = 1/s).
N	Unit? de force (Newton). L'unit? de force [dans le syst?me MKS (m?tre, kilogramme, seconde)] est la force qui communique ? une masse de 1 kilogramme l'acc?l?ration de 1 m?tre par seconde, par seconde.
Pa	Unit? de pression (Pascal = N/m?).
J	Unit? d'?nergie ou de travail (Joule = N*m). Le joule est le travail effectu? lorsque le point d'application de 1 unit? MKS de force [newton] se d?place d'une distance ?gale ? 1 m?tre dans la direction de la force.
W	Unit? de puissance (Watt = J/s). Le watt est la puissance qui donne lieu ? une production d'?nergie ?gale ? 1 joule par seconde.
C	Unit? de quantit? d'?lectricit? (C). Le coulomb est la quantit? d'?lectricit? transport?e en 1 seconde par un courant de 1 amp?re.
V	Unit? de diff?rence de potentiel et de force ?lectromotrice (Volt = W/A). Le volt est la diff?rence de potentiel ?lectrique qui existe entre deux points d'un fil conducteur transportant un courant constant de 1 amp?re, lorsque la puissance dissip?e entre ces points est ?gale ? 1 watt.
F	Unit? de capacit? ?lectrique (Farad = C/V). Le farad est la capacit? d'un condensateur ?lectrique entre les armatures duquel appara?t une diff?rence de potentiel ?lectrique de 1 volt, lorsqu'il est charg? d'une quantit? d'?lectricit? ?gale ? 1 coulomb.
\u03A9	Unit? de r?sistance ?lectrique (Ohm = V/A). L'ohm est la r?sistance ?lectrique qui existe entre deux points d'un conducteur lorsqu'une diff?rence de potentiel constante de 1 volt, appliqu?e entre ces deux points, produit, dans ce conducteur, un courant de 1 amp?re, ce conducteur n'?tant le si?ge d'aucune force ?lectromotrice.
S	Unit? de conductance ?lectrique (Siemmens = A/V).
Wb	Unit? de flux magn?tique (Weber = V*s). Le weber est le flux magn?tique qui, traversant un circuit d'une seule spire, y produirait une force ?lectromotrice de 1 volt, si on l'amenait ? z?ro en 1 seconde par d?croissance uniforme.
T	Unit? d'induction magn?tique (Tesla = Wb/m?).
H	Unit? d'inductance ?lectrique (H = Wb/A). Le henry est l'inductance ?lectrique d'un circuit ferm? dans lequel une force ?lectromotrice de 1 volt est produite lorsque le courant ?lectrique qui parcourt le circuit varie uniform?ment ? raison de 1 amp?re par seconde.
?C	Unit? de temp?rature (Celcius). Notez que cette unit? ne peut pas ?tre multipli?e ou divis?e par d'autres unit?s. Par exemple il ne sera pas possible d'exprimer un gradient de temp?rature en ?C/m. Il faudra au lieu de cela utiliser les degr?s Kelvin (K/m).
lm	Unit? de flux lumineux (Lumen = cd*sr).
lx	Unit? d'?clairement lumineux (Lux = lm/m?).
Bq	Unit? d'activit? d'un radionucl?ide (Becquerel = 1/s)
Gy	Unit? des dose absorb?e, ?nergie massique (communiqu?e), kerma (Gray = J/kg).
Sv	Unit? des ?quivalent de dose, ?quivalent de dose ambiant, ?quivalent de dose directionnel, ?quivalent de dose individuel, dose ?quivalente dans un organe (Sievert = J/kg).
Unit?s Non-SI
min	Minute.
h	Heure.
d	Jour.
?	Degr? d'angle.
'	Minute d'angle.
"	Seconde d'angle.
l ou L	Litre.
t	Tonne m?trique.
Np	Unit? logarithmique. Le neper est utilis? pour exprimer la valeur de grandeurs logarithmiques telles que le niveau de champ, le niveau de puissance, le niveau de pression acoustique ou le d?cr?ment logarithmique. Les logarithmes naturels sont utilis?s pour obtenir les valeurs num?riques des grandeurs exprim?es en nepers. Note: cette unit? n'est pas encore impl?ment?e dans la version actuelle.
Bel	Unit? logarithmique. Le bel est utilis? pour exprimer la valeur de grandeurs logarithmiques telles que le niveau de champ, le niveau de puissance, le niveau de pression acoustique ou l'att?nuation. Les logarithmes de base dix sont utilis?s pour obtenir les valeurs num?riques de grandeurs exprim?es en bels. Le sous-multiple d?cibel, dB, est d'usage courant. Note: cette unit? n'est pas encore impl?ment?e dans la version actuelle.
eV	L'?lectronvolt est l'?nergie cin?tique acquise par un ?lectron apr?s travers?e d'une diff?rence de potentiel de 1V dans le vide.
u	L'unit? de masse atomique unifi?e est ?gale ? 1/12 de la masse d'un atome du nucl?ide 12 C, non li?, au repos, et dans son ?tat fondamental. Dans le domaine de la biochimie, l'unit? de masse atomique unifi?e est aussi appel?e dalton, symbole Da.
ua	L'unit? astronomique est une unit? de longueur; sa valeur est ? peu pr?s ?gale ? la distance moyenne entre la Terre et le soleil. Elle est telle que, lorsqu'elle est utilis?e pour d?crire les mouvements des corps dans le syst?me solaire, la constante gravitationnelle h?liocentrique est de (0,017 202 09895)2ua3?d-2.
inch*	Unit? de longueur (pouce).
foot*	Unit? de longueur (pied).
yard*	Unit? de longueur (yard).
fathom*	Unit? de longueur (brasse anglaise).
brasse*	Unit? de longueur (brasse fran?aise).
mile*	Unit? de longueur (mille).
nmile*	Unit? de longueur (mille marin). Le mille marin est une unit? sp?ciale employ?e en navigation maritime et a?rienne pour exprimer la distance. Cette valeur fut adopt?e par convention par la Premi?re Conf?rence hydrographique internationale extraordinaire, Monaco, 1929, sous le nom de ?mille marin international?. Il n'existe pas de symbole convenu au niveau international. ? l'origine, cette unit? avait ?t? choisie parce qu'un mille marin ? la surface de la Terre est intercept? approximativement par une minute d'angle au centre de la Terre.
knot*	Noeud (vitesse correspondant ? un mille marin par heure).
are	Les unit?s are et hectare et leurs symboles furent adopt?s parle Comit? international en 1879 (PV, 1879, 41) et sont utilis?s pour exprimer des superficies agraires.
ha	Les unit?s are et hectare et leurs symboles furent adopt?s parle Comit? international en 1879 (PV, 1879, 41) et sont utilis?s pour exprimer des superficies agraires.
bar	Unit? de pression (bar). La pression en milieu oc?anographique augmente d'environ 1 dbar par m?tre de profondeur.
?	Unit? de longueur (?ngstr?m).
barn	Le barn est une unit? sp?ciale employ?e en physique nucl?aire pour exprimer les sections efficaces.
erg	Unit? d'?nergie (erg).
dyn	Unit? de force (dyne).
P	Poise.
St	Stokes.
G	Gauss.
Oe	oersted.
Mx	maxwell.
sb	stilb.
ph	phot.
gal	Le gal est une unit? sp?ciale employ?e en g?od?sie et en g?ophysique pour exprimer l'acc?l?ration due ? la pesanteur.
Ci	Le curie est une unit? sp?ciale employ?e en physique nucl?aire pour exprimer l'activit? des radionucl?ides.
R	Le r?ntgen est une unit? sp?ciale employ?e pour exprimer l'exposition aux rayonnements x ou gamma.
rd	Le rad est une unit? sp?ciale employ?e pour exprimer la dose absorb?e de rayonnements ionisants.
rem	Le rem est une unit? sp?ciale employ?e en radioprotection pour exprimer l'?quivalent de dose.
Jy	jansky.
Torr	Unit? de pression (torr).
atm	Unit? de pression (atmosph?re normale).
pounds*	Unit? de poids (livre).
onze*	Unit? de poids (onze).
?F*	Unit? de temp?rature (fahrenheit).

* 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.

Facteur	Pr?fix	Symbole		Facteur	Pr?fix	Symbole
10-1	d?ci	d		101	deca	da
10-2	centi	c		102	hecto	h
10-3	milli	m		103	kilo	k
10-6	micro	µ		106	mega	M
10-9	nano	n		109	giga	G
10-12	pico	p		1012	tera	T
10-15	femto	f		1015	peta	P
10-18	atto	a		1018	exa	E
10-21	zepto	z		1021	zetta	Z
10-24	yocto	y		1024	yotta	Y

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:

Amp?re	Pour les mesures de courants ?lectriques
Candela	Pour les mesures d'intensit?s lumineuses
Kelvin	Pour les mesures de temp?ratures
Kilogramme	Pour les mesures de masses
m?tre	Pour les mesures de longueurs
seconde	Pour les mesures de temps

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 Unit.scale(double) et Unit.shift(double) sur une ancienne unit?. Par exemple on peut cr?er des unit?s de miles nautiques avec:

Unit mile=METRE.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:

Unit degF = degC.scale(5./9).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 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.

Cr?dits

Le paquet org.geotools.units est fortement inspir? de la biblioth?que UD units library, d?velopp?e par Steve Emmerson de Unidata. Cette derni?re est utilis?e entre autre par VisAD, une biblioth?que Java du domaine publique. Dans le cadre du projet org.geotools.units toutefois, le code source a ?t? enti?rement r??crit afin de mieux l'adapter ? nos besoins. Mais l'esprit de base du paquet fut conserv?. Longtemps avant son introduction dans org.geotools.units, il a fait ses preuves aupr?s de d'autres programmeurs. La license de Unidata contenait la mention suivante:

Access and use of this software shall impose the following obligations and understandings on the user. The user is granted the right, without any fee or cost, to use, copy, modify, alter, enhance and distribute this software, and any derivative works thereof, and its supporting documentation for any purpose whatsoever, provided that this entire notice appears in all copies of the software, derivative works and supporting documentation. Further, UCAR requests that the user credit UCAR/Unidata in any publications that result from the use of this software or in any product that includes this software. The names UCAR and/or Unidata, however, may not be used in any advertising or publicity to endorse or promote any products or commercial entity unless specific written permission is obtained from UCAR/Unidata. The user also understands that UCAR/Unidata is not obligated to provide the user with any support, consulting, training or assistance of any kind with regard to the use, operation and performance of this software nor to provide the user with any updates, revisions, new versions or "bug fixes."

THIS SOFTWARE IS PROVIDED BY UCAR/UNIDATA "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL UCAR/UNIDATA BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE ACCESS, USE OR PERFORMANCE OF THIS SOFTWARE.