JSR-275 - Measurements and Units Specification

javax.measure.unit
Class SI

java.lang.Object
  extended by javax.measure.unit.SI

public final class SI
extends java.lang.Object

This class contains SI (Système International d'Unités) base units, and derived units.

It also defines the 20 SI prefixes used to form decimal multiples and submultiples of SI units. For example:

     import static org.jscience.physics.units.SI.*; // Static import.
     ...
     Unit<Pressure> HECTO_PASCAL = HECTO(PASCAL);
     Unit<Length> KILO_METER = KILO(METER);
     

A collection of all the SI units defined can be retrieved using the SI.units() static method.

Version:
3.1, April 19, 2006
Author:
Jean-Marie Dautelle
See Also:
Wikipedia: SI, Wikipedia: SI prefix

Field Summary
static BaseUnit<ElectricCurrent> AMPERE
          The base unit for electric current quantities (A).
static AlternateUnit<RadioactiveActivity> BECQUEREL
          The derived unit for activity of a radionuclide (Bq).
static AlternateUnit<DataAmount> BIT
          The unit for binary information (bit).
static BaseUnit<LuminousIntensity> CANDELA
          The base unit for luminous intensity quantities (cd).
static Unit<Temperature> CELSIUS
          The derived unit for Celsius temperature ().
static AlternateUnit<ElectricCharge> COULOMB
          The derived unit for electric charge, quantity of electricity (C).
static Unit<Volume> CUBIC_METER
          The metric unit for volume quantities ().
static AlternateUnit<ElectricCapacitance> FARAD
          The derived unit for capacitance (F).
static Unit<Mass> GRAM
          The derived unit for mass quantities (g).
static AlternateUnit<RadiationDoseAbsorbed> GRAY
          The derived unit for absorbed dose, specific energy (imparted), kerma (Gy).
static AlternateUnit<ElectricInductance> HENRY
          The derived unit for inductance (H).
static AlternateUnit<Frequency> HERTZ
          The derived unit for frequency (Hz).
static AlternateUnit<Energy> JOULE
          The derived unit for energy, work, quantity of heat (J).
static AlternateUnit<CatalyticActivity> KATAL
          The derived unit for catalytic activity (kat).
static BaseUnit<Temperature> KELVIN
          The base unit for thermodynamic temperature quantities (K).
static BaseUnit<Mass> KILOGRAM
          The base unit for mass quantities (kg).
static AlternateUnit<LuminousFlux> LUMEN
          The derived unit for luminous flux (lm).
static AlternateUnit<Illuminance> LUX
          The derived unit for illuminance (lx).
static BaseUnit<Length> METER
          The base unit for length quantities (m).
static Unit<Velocity> METER_PER_SECOND
          The metric unit for velocity quantities (m/s).
static Unit<Acceleration> METER_PER_SQUARE_SECOND
          The metric unit for acceleration quantities (m/s²).
static BaseUnit<AmountOfSubstance> MOLE
          The base unit for amount of substance quantities (mol).
static AlternateUnit<Force> NEWTON
          The derived unit for force (N).
static AlternateUnit<ElectricResistance> OHM
          The derived unit for electric resistance (Ω or Ohm).
static AlternateUnit<Pressure> PASCAL
          The derived unit for pressure, stress (Pa).
static AlternateUnit<Angle> RADIAN
          The unit for plane angle quantities (rad).
static BaseUnit<Duration> SECOND
          The base unit for duration quantities (s).
static AlternateUnit<ElectricConductance> SIEMENS
          The derived unit for electric conductance (S).
static AlternateUnit<RadiationDoseEffective> SIEVERT
          The derived unit for dose equivalent (Sv).
static Unit<Area> SQUARE_METER
          The metric unit for area quantities ().
static AlternateUnit<SolidAngle> STERADIAN
          The unit for solid angle quantities (sr).
static AlternateUnit<MagneticFluxDensity> TESLA
          The derived unit for magnetic flux density (T).
static AlternateUnit<ElectricPotential> VOLT
          The derived unit for electric potential difference, electromotive force (V).
static AlternateUnit<Power> WATT
          The derived unit for power, radiant, flux (W).
static AlternateUnit<MagneticFlux> WEBER
          The derived unit for magnetic flux (Wb).
 
Method Summary
static
<Q extends Quantity>
Unit<Q>
ATTO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-18
static
<Q extends Quantity>
Unit<Q>
CENTI(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-2
static
<Q extends Quantity>
Unit<Q>
DECI(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-1
static
<Q extends Quantity>
Unit<Q>
DEKA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 101
static
<Q extends Quantity>
Unit<Q>
EXA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 1018
static
<Q extends Quantity>
Unit<Q>
FEMTO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-15
static
<Q extends Quantity>
Unit<Q>
GIGA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 109
static
<Q extends Quantity>
Unit<Q>
HECTO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 102
static
<Q extends Quantity>
Unit<Q>
KILO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 103
static
<Q extends Quantity>
Unit<Q>
MEGA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 106
static
<Q extends Quantity>
Unit<Q>
MICRO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-6
static
<Q extends Quantity>
Unit<Q>
MILLI(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-3
static
<Q extends Quantity>
Unit<Q>
NANO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-9
static
<Q extends Quantity>
Unit<Q>
PETA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 1015
static
<Q extends Quantity>
Unit<Q>
PICO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-12
static
<Q extends Quantity>
Unit<Q>
TERA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 1012
static java.util.Set<Unit<?>> units()
          Returns a read only view over the SI units defined in this class.
static
<Q extends Quantity>
Unit<Q>
YOCTO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-24
static
<Q extends Quantity>
Unit<Q>
YOTTA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 1024
static
<Q extends Quantity>
Unit<Q>
ZEPTO(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 10-21
static
<Q extends Quantity>
Unit<Q>
ZETTA(Unit<Q> unit)
          Returns the specified unit multiplied by the factor 1021
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

AMPERE

public static final BaseUnit<ElectricCurrent> AMPERE
The base unit for electric current quantities (A). The Ampere is that constant current which, if maintained in two straight parallel conductors of infinite length, of negligible circular cross-section, and placed 1 metre apart in vacuum, would produce between these conductors a force equal to 2 × 10-7 newton per metre of length. It is named after the French physicist Andre Ampere (1775-1836).


CANDELA

public static final BaseUnit<LuminousIntensity> CANDELA
The base unit for luminous intensity quantities (cd). The candela is the luminous intensity, in a given direction, of a source that emits monochromatic radiation of frequency 540 × 1012 hertz and that has a radiant intensity in that direction of 1/683 watt per steradian

See Also:
Wikipedia: Candela

KELVIN

public static final BaseUnit<Temperature> KELVIN
The base unit for thermodynamic temperature quantities (K). The kelvin is the 1/273.16th of the thermodynamic temperature of the triple point of water. It is named after the Scottish mathematician and physicist William Thomson 1st Lord Kelvin (1824-1907)


KILOGRAM

public static final BaseUnit<Mass> KILOGRAM
The base unit for mass quantities (kg). It is the only SI unit with a prefix as part of its name and symbol. The kilogram is equal to the mass of an international prototype in the form of a platinum-iridium cylinder kept at Sevres in France.

See Also:
GRAM

METER

public static final BaseUnit<Length> METER
The base unit for length quantities (m). One meter was redefined in 1983 as the distance traveled by light in a vacuum in 1/299,792,458 of a second.


MOLE

public static final BaseUnit<AmountOfSubstance> MOLE
The base unit for amount of substance quantities (mol). The mole is the amount of substance of a system which contains as many elementary entities as there are atoms in 0.012 kilogram of carbon 12.


SECOND

public static final BaseUnit<Duration> SECOND
The base unit for duration quantities (s). It is defined as the duration of 9,192,631,770 cycles of radiation corresponding to the transition between two hyperfine levels of the ground state of cesium (1967 Standard).


GRAM

public static final Unit<Mass> GRAM
The derived unit for mass quantities (g). The base unit for mass quantity is KILOGRAM.


RADIAN

public static final AlternateUnit<Angle> RADIAN
The unit for plane angle quantities (rad). One radian is the angle between two radii of a circle such that the length of the arc between them is equal to the radius.


STERADIAN

public static final AlternateUnit<SolidAngle> STERADIAN
The unit for solid angle quantities (sr). One steradian is the solid angle subtended at the center of a sphere by an area on the surface of the sphere that is equal to the radius squared. The total solid angle of a sphere is 4*Pi steradians.


BIT

public static final AlternateUnit<DataAmount> BIT
The unit for binary information (bit).


HERTZ

public static final AlternateUnit<Frequency> HERTZ
The derived unit for frequency (Hz). A unit of frequency equal to one cycle per second. After Heinrich Rudolf Hertz (1857-1894), German physicist who was the first to produce radio waves artificially.


NEWTON

public static final AlternateUnit<Force> NEWTON
The derived unit for force (N). One newton is the force required to give a mass of 1 kilogram an Force of 1 metre per second per second. It is named after the English mathematician and physicist Sir Isaac Newton (1642-1727).


PASCAL

public static final AlternateUnit<Pressure> PASCAL
The derived unit for pressure, stress (Pa). One pascal is equal to one newton per square meter. It is named after the French philosopher and mathematician Blaise Pascal (1623-1662).


JOULE

public static final AlternateUnit<Energy> JOULE
The derived unit for energy, work, quantity of heat (J). One joule is the amount of work done when an applied force of 1 newton moves through a distance of 1 metre in the direction of the force. It is named after the English physicist James Prescott Joule (1818-1889).


WATT

public static final AlternateUnit<Power> WATT
The derived unit for power, radiant, flux (W). One watt is equal to one joule per second. It is named after the British scientist James Watt (1736-1819).


COULOMB

public static final AlternateUnit<ElectricCharge> COULOMB
The derived unit for electric charge, quantity of electricity (C). One Coulomb is equal to the quantity of charge transferred in one second by a steady current of one ampere. It is named after the French physicist Charles Augustin de Coulomb (1736-1806).


VOLT

public static final AlternateUnit<ElectricPotential> VOLT
The derived unit for electric potential difference, electromotive force (V). One Volt is equal to the difference of electric potential between two points on a conducting wire carrying a constant current of one ampere when the power dissipated between the points is one watt. It is named after the Italian physicist Count Alessandro Volta (1745-1827).


FARAD

public static final AlternateUnit<ElectricCapacitance> FARAD
The derived unit for capacitance (F). One Farad is equal to the capacitance of a capacitor having an equal and opposite charge of 1 coulomb on each plate and a potential difference of 1 volt between the plates. It is named after the British physicist and chemist Michael Faraday (1791-1867).


OHM

public static final AlternateUnit<ElectricResistance> OHM
The derived unit for electric resistance (Ω or Ohm). One Ohm is equal to the resistance of a conductor in which a current of one ampere is produced by a potential of one volt across its terminals. It is named after the German physicist Georg Simon Ohm (1789-1854).


SIEMENS

public static final AlternateUnit<ElectricConductance> SIEMENS
The derived unit for electric conductance (S). One Siemens is equal to one ampere per volt. It is named after the German engineer Ernst Werner von Siemens (1816-1892).


WEBER

public static final AlternateUnit<MagneticFlux> WEBER
The derived unit for magnetic flux (Wb). One Weber is equal to the magnetic flux that in linking a circuit of one turn produces in it an electromotive force of one volt as it is uniformly reduced to zero within one second. It is named after the German physicist Wilhelm Eduard Weber (1804-1891).


TESLA

public static final AlternateUnit<MagneticFluxDensity> TESLA
The derived unit for magnetic flux density (T). One Tesla is equal equal to one weber per square meter. It is named after the Serbian-born American electrical engineer and physicist Nikola Tesla (1856-1943).


HENRY

public static final AlternateUnit<ElectricInductance> HENRY
The derived unit for inductance (H). One Henry is equal to the inductance for which an induced electromotive force of one volt is produced when the current is varied at the rate of one ampere per second. It is named after the American physicist Joseph Henry (1791-1878).


CELSIUS

public static final Unit<Temperature> CELSIUS
The derived unit for Celsius temperature (). This is a unit of temperature such as the freezing point of water (at one atmosphere of pressure) is 0 ℃, while the boiling point is 100 ℃.


LUMEN

public static final AlternateUnit<LuminousFlux> LUMEN
The derived unit for luminous flux (lm). One Lumen is equal to the amount of light given out through a solid angle by a source of one candela intensity radiating equally in all directions.


LUX

public static final AlternateUnit<Illuminance> LUX
The derived unit for illuminance (lx). One Lux is equal to one lumen per square meter.


BECQUEREL

public static final AlternateUnit<RadioactiveActivity> BECQUEREL
The derived unit for activity of a radionuclide (Bq). One becquerel is the radiation caused by one disintegration per second. It is named after the French physicist, Antoine-Henri Becquerel (1852-1908).


GRAY

public static final AlternateUnit<RadiationDoseAbsorbed> GRAY
The derived unit for absorbed dose, specific energy (imparted), kerma (Gy). One gray is equal to the dose of one joule of energy absorbed per one kilogram of matter. It is named after the British physician L. H. Gray (1905-1965).


SIEVERT

public static final AlternateUnit<RadiationDoseEffective> SIEVERT
The derived unit for dose equivalent (Sv). One Sievert is equal is equal to the actual dose, in grays, multiplied by a "quality factor" which is larger for more dangerous forms of radiation. It is named after the Swedish physicist Rolf Sievert (1898-1966).


KATAL

public static final AlternateUnit<CatalyticActivity> KATAL
The derived unit for catalytic activity (kat).


METER_PER_SECOND

public static final Unit<Velocity> METER_PER_SECOND
The metric unit for velocity quantities (m/s).


METER_PER_SQUARE_SECOND

public static final Unit<Acceleration> METER_PER_SQUARE_SECOND
The metric unit for acceleration quantities (m/s²).


SQUARE_METER

public static final Unit<Area> SQUARE_METER
The metric unit for area quantities ().


CUBIC_METER

public static final Unit<Volume> CUBIC_METER
The metric unit for volume quantities ().

Method Detail

YOTTA

public static <Q extends Quantity> Unit<Q> YOTTA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 1024

Parameters:
unit - any unit.
Returns:
unit.multiply(1e24).

ZETTA

public static <Q extends Quantity> Unit<Q> ZETTA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 1021

Parameters:
unit - any unit.
Returns:
unit.multiply(1e21).

EXA

public static <Q extends Quantity> Unit<Q> EXA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 1018

Parameters:
unit - any unit.
Returns:
unit.multiply(1e18).

PETA

public static <Q extends Quantity> Unit<Q> PETA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 1015

Parameters:
unit - any unit.
Returns:
unit.multiply(1e15).

TERA

public static <Q extends Quantity> Unit<Q> TERA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 1012

Parameters:
unit - any unit.
Returns:
unit.multiply(1e12).

GIGA

public static <Q extends Quantity> Unit<Q> GIGA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 109

Parameters:
unit - any unit.
Returns:
unit.multiply(1e9).

MEGA

public static <Q extends Quantity> Unit<Q> MEGA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 106

Parameters:
unit - any unit.
Returns:
unit.multiply(1e6).

KILO

public static <Q extends Quantity> Unit<Q> KILO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 103

Parameters:
unit - any unit.
Returns:
unit.multiply(1e3).

HECTO

public static <Q extends Quantity> Unit<Q> HECTO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 102

Parameters:
unit - any unit.
Returns:
unit.multiply(1e2).

DEKA

public static <Q extends Quantity> Unit<Q> DEKA(Unit<Q> unit)
Returns the specified unit multiplied by the factor 101

Parameters:
unit - any unit.
Returns:
unit.multiply(1e1).

DECI

public static <Q extends Quantity> Unit<Q> DECI(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-1

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-1).

CENTI

public static <Q extends Quantity> Unit<Q> CENTI(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-2

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-2).

MILLI

public static <Q extends Quantity> Unit<Q> MILLI(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-3

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-3).

MICRO

public static <Q extends Quantity> Unit<Q> MICRO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-6

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-6).

NANO

public static <Q extends Quantity> Unit<Q> NANO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-9

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-9).

PICO

public static <Q extends Quantity> Unit<Q> PICO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-12

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-12).

FEMTO

public static <Q extends Quantity> Unit<Q> FEMTO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-15

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-15).

ATTO

public static <Q extends Quantity> Unit<Q> ATTO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-18

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-18).

ZEPTO

public static <Q extends Quantity> Unit<Q> ZEPTO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-21

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-21).

YOCTO

public static <Q extends Quantity> Unit<Q> YOCTO(Unit<Q> unit)
Returns the specified unit multiplied by the factor 10-24

Parameters:
unit - any unit.
Returns:
unit.multiply(1e-24).

units

public static java.util.Set<Unit<?>> units()
Returns a read only view over the SI units defined in this class.

Returns:
the collection of SI units.

JSR-275 - Measurements and Units Specification

Copyright © 2007 JSR-275