unitsofmeasurement / seshat

Seshat Units of Measurement Implementation

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Seshat Units of Measurement Implementation

CircleCI Stability: Active License

Seshat (from the ancient Egyptian goddess of knowledge, writing and surveying) is an implementation of Units of Measurement API defined by JSR 385. Seshat is a subset of Apache Spatial Information System (SIS) library keeping only the classes required for JSR 385 implementation. Seshat supports arithmetic operations on units and on quantities. The unit (including SI prefix) and the quantity type resulting from those arithmetic operations are automatically inferred. For example this line of code:

System.out.println( Units.PASCAL.multiply(1000) );

prints "kPa", i.e. the kilo prefix has been automatically applied (SI prefixes are applied on SI units only, not on other systems). Other example:

Force  f = Quantities.create(4, Units.NEWTON);
Length d = Quantities.create(6, Units.MILLIMETRE);
Time   t = Quantities.create(3, Units.SECOND);
Quantity<?> e = f.multiply(d).divide(t);
System.out.println(e);
System.out.println("Instance of Power: " + (e instanceof Power));

prints:

8 mW
Instance of Power: true

In this example, Seshat detects that the result of N*m/s is Watt, inherits the milli prefix from millimetre and creates an instance of Power, not just Quantity<Power> (the generic parent).

Parsing and formatting use Unicode symbols by default, as in µg/m². Parenthesis are recognized at parsing time and used for denominators at formatting time, as in kg/(m²⋅s). While uncommon, Seshat accepts fractional powers as in m^⅔. Some sentences like "100 feet", "square metre" and "degree Kelvin" are also recognized at parsing time.

Seshat requires Java 11 and has no dependency other than JSR 385 and java.base module.

Maven dependency

Latest release can be used in a Maven project with following configuration:

<project>
  <dependencies>
    <dependency>
      <groupId>tech.uom</groupId>
      <artifactId>seshat</artifactId>
      <version>1.3</version>
    </dependency>
  </dependencies>
</project>

Links

About

Seshat Units of Measurement Implementation

License:Apache License 2.0


Languages

Language:Java 100.0%