https://github.com/uhoefel/quantities

A library for handling quantities.
https://github.com/uhoefel/quantities

Last synced: 11 days ago
JSON representation

A library for handling quantities.

• Host: GitHub
• URL: https://github.com/uhoefel/quantities
• Owner: uhoefel
• License: mit
• Created: 2020-11-10T19:23:10.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-02-20T12:20:51.000Z (11 months ago)
• Last Synced: 2024-03-15T00:01:52.611Z (10 months ago)
• Language: Java
• Size: 145 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Quantities

[![](https://img.shields.io/github/issues/uhoefel/quantities?style=flat-square)](https://github.com/uhoefel/quantities/issues)

[![](https://img.shields.io/github/stars/uhoefel/quantities?style=flat-square)](https://github.com/uhoefel/quantities/stargazers)

[![DOI](https://zenodo.org/badge/311762187.svg)](https://zenodo.org/badge/latestdoi/311762187)

[![Maven Central](https://img.shields.io/maven-central/v/eu.hoefel/quantities.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22eu.hoefel%22%20AND%20a:%22quantities%22)

[![](https://img.shields.io/github/license/uhoefel/quantities?style=flat-square)](https://choosealicense.com/licenses/mit/)

Quantities is a [Java](https://openjdk.java.net/) library designed to handle values in combination with [units](https://github.com/uhoefel/units) and, in contrast to (all?) other quantity handling libraries, [coordinate systems](https://github.com/uhoefel/coordinates) (including curvilinear, non-orthogonal ones).

This allows for richer metadata, while degrading gracefully if not all metadata is provided explicitly.

All of the implementations are immutable and null-hostile.

Some of the supported features include:

- Support for scalar and vector fields. For example

  ```java

  var scalarField = new ScalarField("magnitude of B", val -> 2 * val, new CartesianCoordinates(1), new CartesianCoordinates(1));

  var q0d = new Quantity0D(12, Unit.of("mm"));

  assertArrayEquals(new double[] {0.024}, scalarField.apply(q0d).value());

  ```

- Apply simple functions. For example

  ```java

  var quantity = new Quantity0D(-3.0, Unit.of("m"));

  var quantityWithAppliedFunction = quantity.apply(Math::abs); // value is Math.abs(-3)

  ```

- Approach target values by changing unit prefixes on the axes (useful e.g. for autoranging for optimizers). For example

  ```java

  var quantity = new Quantity0D(1.024e6, Unit.of("g"));

  var quantityApproaching1 = quantity.approach(1); // 1.024 Mg

  ```

Installation

============

The artifact can be found at maven central:

```xml

    eu.hoefel

    quantities

    0.10.2

```

Requirements

============

Quantities is designed to work with Java 17+.